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Prologue 


There's an old joke about a fellow who gets lost and stops his car to ask a 
farmer how to get to the City. The farmer thinks a moment, spits, and then 
replies "Can't get there from here.” 


For some reason, that rancid old line keeps coming back to me every time I'm 
asked about just how Red Ryder came to be. Let me explain. 


Red Ryder is a fluke. When I bought my 128K Macintosh in early 1984, | had a 
gut feeling that it was the riskiest, and probably the poorest investment I'd ever 
made. The total inventory of available software was about a half dozen 
products, including MacPaint, and MacWrite (which at that time came free with 
the Macintosh). The only development language available was Microsoft 
BASIC 1.0. I'd shelled out nearly two grand for something that did almost 
nothing. 


Being a modem fanatic, the first thing | wanted to do was write a program that 
would allow me to download MS-BASIC programs from IBM-PC bulletin board 
systems so that | could convert them to run on a Mac, and in doing so, increase 
my library of Mac software. Red Ryder 1.0 was born. It was written with MS- 
BASIC 1.0. 


Despite its severe limitations, it quickly became clear that Red Ryder 1.0 was 
useful to others besides myself. Having had an extraordinarly bad experience 
with a software publisher in the past, | was more than a little hesitant to take that 
path again. About that time, the concept of user supported software was 
becoming popular because of an IBM-PC communications program called PC- 
TALK. PC-TALK was wildly successful, and if nothing else, proved to me that | 
wasn't the only one who had thousands of dollars worth of lousy software on my 
shelves. Clearly, the computer industry was hungry for decent software at a 
decent price. | felt that much of the software at that time was being sold as if it 
were underarm deordorant or toothpaste, complete with flashy packaging, 
deceptive advertising, and distributors interested more in commissions than 
integrity. 


Red Ryder became a passionate experiment. While | knew l couldn't defeat 
Samson, ! took on a "what the hell" attitude that convinced me that it would at 
least be fun to give him the finger. My theory was that it was time for a software 
product that had thousands of project managers - the consumers. An ultimate 
test of capitalism. Break some rules, dammit! | became a technocrat who 
despised the army of corporate bean counters who were bastardizing our 
personal revolution. 


| quit my job and decided to start up The FreeSoft Company. My philosopy was 


(and still is) simple: "If my product isn't useful, or if | charge too much for it, | 
deserve to go out of business." Don't get me wrong, | wasn't naive. | knew 
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about and practiced what some companies refer to as “software piracy". 


My rationale for using software before | paid for it was that | became entirely 
convinced that the advertising and P.R. flacks had fine tuned the art of 
deception into a science. Unlike an automobile, | knew that if | test drove a 
piece of software and was absolutely convinced that it performed the job | 
needed, | couldn't later be stuck with a lemon. ! became an outlaw out of 
financial necessity. For moral reasons, then, | had no other choice than to 
market Red Ryder as shareware. 


This wasn't like walking through Times Square with your wallet on your head. | 
never felt like | had to protect myself against common thugs by doing this. | 
knew that 1 would be dealing with a higher class of people. People who 
understand right from wrong. Red Ryder was like a modernized version of Abby 
Hoffman's "Steal This Book", except that it was marketed by a conservative 
capitalist from Missouri . 


If it's good, and you use it, you are morally and ethically bound to pay for it. | 
like that spirit. | embrace it. i depend upon it. Most of us do. 


The shareware marketing concept is simple. It is too prove to you that | am not 
interested in cheating you when we do business. | am convinced that the first 
nine versions of Red Ryder have proved that. | am now confident that the 
Macintosh owners are also confident of that. There are many good reasons 
why this version could not be marketed as shareware (the size of this manua! 
alone is #1 on the list). But, before | get accused of selling out, | wish to submit 
that | have paid my dues. 


But like | said, I'm not naive. Please continue to give out copies of version 9.4 to 
anyone and everyone as the "trial version". If you give out this version without 
the manual, a person will no doubt become quickly lost, and will never know 
what Red Ryder can do for them. And... it makes technical support Hell - believe 
me. Please understand that ! can better serve you by working on the next 
version of Red Ryder, as well as other projects, than 1 can explaining to 
someone for the 10,000th time what would be clear if they just had this 
documentation. Not only will you be hurting a person by giving them a copy of 
this version without the documentation, you will hurt yourself in the long run 
because my time will have to be spent on something else than new product 
development. In other words, by protecting me, you protect your investment. 


As | write this paragraph, | know that this milestone is very close to being 
completed. More hours of development have gone into this version than all of 
the others combined, in which time | have worked myself into the hospital twice, 
have given up the "luxuries" of a proper diet and something called sleep, and 
have pulled this version out of beta test and back into development six times 
because ! wasn't completely happy with it. It's been a long damn road. You 
can't get there from here, as the saying goes. 
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One thing that won't change about Red Ryder is the fact that | will never 
consider it "finished", and | rely heavily on you to tell me what is right and wrong 
about it. | beg you to write and tell me what you want to see in future versions. | 
read all of your suggestions and take them to heart. | only wish that ! could be 
there to see the smiles on those peoples' faces who will see their wish list (or at 
least part of it) implemented in this version. This version is definitely a 
milestone, but it in no way marks the end of the trail. 


| wish you the best results from your pursuits, and | hope to run into you soon 
online or in person. 


Sincerely, 
Scott Watson 
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What's In A Filename? 


In various places throughout this manual, the word filename is used to indicate 
a group of characters that describe the location of a file (either a Macintosh 
application or document) on a disk. There are different ways of doing this, 
depending on the kind of filing system you are using. 


The original Macintosh filing system was called MFS (Macintosh Filing System), 
which worked well for floppy disks. Folders that are displayed in a Finder 
window are for cosmetic purposes only, and they do not play a part in 
constructing a filename for Red Ryder. An MFS filename consists of the disk 
volume name (which appears under the disk icon in the Finder), a colon 
character, and the name of the file (which appears under the file's icon in the 
Finder). 


Under MFS, a file with the name of "Junk" that resides on a disk named "Stuff" 
would be given the filename "Stuff:Junk" 


When hard disks became common in the Macintosh world, it became necessary 
for Apple to devise a more efficient filing system, which they named HFS 
(Hierarchical Filing System). Under HFS, the names of folders which lie 
between the desktop (the top level window in the Finder) and the file are 
significant and must be included in the filename in the order they appear and 
seperated by colon characters. An example should clarify this. 


Under HFS, a file named "Junk" is inside of a folder named "Garbage". The 
"Garbage" folder is inside of another folder named "Trash". The "Trash" folder 
lies on the desktop of a disk named "Stuff". The proper filename would then be: 
"Stuff: Trash:Garbage:Junk 


How do you know if a disk uses HFS or MFS? Open the disk icon in the Finder 
and look at the upper left hand corner of the window. There is a small division 
between the two lines that appear just below the phrase that tells you the 
number of items on the disk. A HFS disk will have an extra dot at the far left of 
this division, and a MFS disk will have no dots in this division. The illustration 
below shows an example of both kinds of disks. 
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It's important to know what kind of disks you are working with so that you don't 
construct a faulty filename and get the dreaded "File Not Found" error message. 


One last tip. If you are sure that you've spelled everything correctly and are 
positive a filename should work but doesn't, you should be aware that the 
Finder allows you to (inadvertently or otherwise) put leading or trailing spaces 
in disk, folder, and file names. If these are present, they must be included in the 
filename you present to Red Ryder. So, if problems persist, try renaming the 
entities in a filename to make sure none of these "ghost" spaces exist. 
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The Terminal Display Window 


When Red Ryder is operating, two major components are immediately visible in 
your display screen, the menu bar at the top of the screen, and the Terminal! 
Display Window immediately below that. 


The Terminal Display Window is where most of the action in Red Ryder takes 
place. It consists of several parts, each of which will be discussed in detail. The 
entire Terminal Display Window can be made invisible by selecting the Hide 
Terminal Window command under the Local menu. When it's hidden, you 
can bring back the Terminal Display Window by choosing Hide Terminal 
Window again. You probably will not make much use of this command, but be 
aware that Procedure files may hide the Terminal Display Window at certain 
times to keep the display uncluttered. Therefore, if the window disappears 
when you don't want it to, you can choose Hide Terminal Window (to 
uncheckmark it) to bring it back. 


By choosing the Bring Other Open Windows To Top command from under 
the Local menu, you can bring any other open windows (such as those used 
by desk accessories) to the top of the desktop and send the Terminal Display 
Window to the rear. 


e The Title Bar 

¢ The Close Box 

« The Zoom Box 

e The Size Box 

« The Horizontal Scroll Bar 
* The Vertical Scroll Bar 

e The Text Display Area 

« The Status Bar 


The Title Bar 

In the center of the Title Bar is displayed the version number of the Red Ryder 
application you are using. When a compiled Procedure File is executing (these 
are discussed later in this manual), the file name of the Procedure File is 
displayed there. The Close Box and Zoom Box are also contained in the Title 
Bar. The Terminal Display Window can be dragged around the Macintosh 
video screen in a standard manner by clicking and dragging in the Title Bar. 


The Close Box 
The lefthand corner of the Title Bar contains the Close Box. Clicking your 


mouse and releasing in the Close Box is equivalent to choosing Quit from 
under Red Ryder's File menu. Execution is terminated and you are returned to 
the Finder. 


The Zoom Box 
On all Macintosh models except the 128K and 512K (unenhanced), a Zoom Box 
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is displayed in the righthand corner of the Title Bar. Clicking in the Zoom Box 
will alternate between growing the window to the full screen size, and shrinking 
it to the last size you were using. 


Th ize B 

The Size Box is located in the bottom righthand corner of the Terminal Display 
Window. It is used in a standard manner to enlarge or shrink the size of the 
Terminal Display Window. In case you're wondering (or have an awfully large 
display screen), the largest Terminal Display Screen you may have is about 
32,000 pixels wide by 32,000 pixels high. This should be sufficient for most 
users for the near future. 


The Horizontal roll Bar 

The Horizontal Scroll Bar is located at the bottom of the Terminal Display 
Window. It is active when the maximum column width number of the widest 
character is too wide to fit entirely in the Terminal Display Window. When this 
occurs, the Horizontal Scroll Bar is used to scroll left and right as needed to see 
all of a line. 


Here's a trick. Rarely if ever will you receive a full line of the widest character in 
a font, so there's quite a bit of unused "white" space at the rightmost part of the 
scrolling region when you use a proportionally sized font. If you hold down the 
Option key and click your mouse in the "Page Right" area of the Horizontal 
Scroll Bar (the grey area between the thumb and right arrow box), Red Ryder 
will scroll right to the point where the widest character in the displayed lines will 
be flush with the right edge of the Terminal Display Window. Holding down the 
Option key and clicking in the "Page Left" part of the Horizontal Scroll Bar is 
equivalent to dragging the thumb all the way to the left. 


he Vertical r 
The Vertical Scroll Bar is located on the righthand edge of the Terminal Display 
Window. It is used to scroll back through lines of text already received, but no 
longer displayed in the Terminal Display Window. Red Ryder defaults to 
remembering the last 24 lines of text received, but you can extend this to cause 
Red Ryder to remember as many screens of received text as you have free 
memory to hold. To change the number of screens Red Ryder will remember in 
this saved screens buffer, select Set Saved Screens Buffer Size... 
from under the Customize menu. On a 512K Macintosh, you could 
comfortably set this buffer size to hold 25 to 50 screens if all free memory is 
available to Red Ryder. 


| recommend that you not set this buffer to an extraordinarily large size without 
purpose. Otherwise, functions that erase all screens (which include the Clear 
All Screens choice under the Local menu, or changing the font, emulation, or 
column width) can take an annoying amount of time. 


Here's another trick. If you save 20 screens of text in the saved screens buffer, 
there can be a lot of empty "white space" in the buffer until 20 screens have 
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been received. If you hold down the Option key and click in the "Page Up" 
portion of the Vertical Scroll Bar (the grey area between the thumb and the up 
arrow box), Red Ryder will position the thumb to the first non-empty line in the 
buffer (the first line of text received). Holding down the Option key and clicking 
in the "Page Down" area of the Vertical Scroll Bar is equivalent to dragging the 
thumb all of the way to the bottom. Typing any character on the keyboard when 
the Vertical Scroll Bar is anywhere but at its bottom position will automatically 
move the Vertical Scroll Bar to its bottom position. 


Ihe Text Display Area 

The Text Display Area is located below the Status Bar and above the Horizontal 
Scroll Bar. This area is where all data received through the serial port (except 
during XMODEM, Kermit, or CompuServe 'B' protocol file transfers) is 
displayed. 


You can quickly locate a desired string of characters by choosing Find Text... 
from under the Edit menu. Red Ryder will search from the top of the Saved 
Screens Buffer to the bottom and point out the first occurance (if there is one) of 
the string of characters you specify. Whenever the text display area is scrolled 
to display the found text, a zooming rectangle is displayed to help you locate the 
found text. Whether or not the window scrolls, the found text will flash several 
times. You can continue searching through the buffer by choosing Find Same 
Text Again from under the Edit menu repeatedly until the search reaches the 
bottommost screen of text. 


You can erase just the text in the Terminal Display Area by choosing Clear 
Display Screen from under the Local menu. To erase all text in the Saved 
Screens Buffer (and Terminal Display Area), choose Clear All Screens from 
under the Local menu. | 


The text in this area is not editable as in a word processor, but you can copy text 
from the screen to the Clipboard, or paste text from the clipboard to the modem. 
Text is selected by dragging the mouse across it as with a word processor. As 
text is selected, it is shown inverted (white characters on a black background). 
You can scroll horizontally or vertically if the appropriate scroll bar is active by 
dragging your mouse outside of the Text Display Area in the direction you wish 
to scroll. 


A quick way to select a block of text is to click your mouse once at the beginning 
of the block, then hold down the Shift key and click once at the end of the block. 
The entire block will then be shown as selected. 


If you select text and then change your mind, you can click your mouse 
anywhere in the terminal display window and the selection will be undone. 
Once text is selected, you may choose either Copy, Copy Table, Print 
Selected Text, or Append To Archive File from under the Edit menu. 


The Copy And Copy Table Commands 
Under the Edit menu, the Copy command will copy all of the selected text into 
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the Clipboard file. The Copy Table command works in much the same way, 
except that it helps you later import data from the screen into a spreadsheet or 
database application. Copy Table looks for more than one space character in 
a row, and converts all of the consecutive spaces to a single tab character. The 
data in the Clipboard is then referred to as "tab delimited", which many 
spreadsheets and database programs allow to be imported (consult the user 
manuals or manufacturers of these programs - not FreeSoft - for more details on 
how to import tab delimited data). Copy Table leaves ail single spaces alone. 


The Print Selected Text Command 


Under the Edit menu, the Print Selected Text command will send the 
selected data to your printer. See the "Using A Printer With Red Ryder" chapter 
in this manual for more details about printing. If the selected text is more than 
100 characters long, Red Ryder will save the selected data in a temporary text 
file, and then automatically use the Print TEXT File... command (explained 
later) to print the file. After printing, the temporary text file is automatically 
deleted from the disk. This is mentioned only because if you select a large 
amount of data, there may be a noticeable delay before printing begins while 
Red Ryder collects data into the temporary text file. 


The Append Data To Archive Fil mmand 

Under the Edit menu, the Append Data To Archive File command either 
creates a new file called "Archived Screens" if one doesn't exist, or appends to 
the end of an existing "Archived Screens" file the selected text. 


Each time Red Ryder starts up, it will use the same disk (and HFS folder) that 
Red Ryder is located in for the "Archived Screens" file. You can change the 
location of the "Archived Screens" file that Red Ryder will create or append to by 
choosing the Set Archive Volume... command under the File menu. That 
volume (or HFS folder) will then be used until it is either changed again, or you 
quit Red Ryder. 


The "Archived Screens" file is a plain text file, which means that it can be 
imported into any Macintosh text editor or word processor (see the user manual 
for your text editor or word processor for details on loading plain text files). 


There are two menu commands for appending text to the "Archived Screens" 
file. Choosing Archive Display Screen from under the Local menu will 
save only those lines of text displayed in the Terminal Display Window. If you 
wish to save all of the text in the Saved Screens Buffer, choose Archive All 
Screens from under the Local menu. This command will not save any blank 
lines in the saved screens buffer until it comes to the first non-empty line in the 
buffer. 


The Paste Command 
Under the Edit menu, the Paste command will send the contents of the 


Clipboard to the serial port. What is actually happening here is that Red Ryder 
creates a temporary text file and copies the text in the Clipboard into this file. it 
then uses the Send Text File... menu choice to send the data to the serial 
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port (this command is discussed in more detail in the "Getting It From There To 
Here Or Here To There” chapter). Once the file is sent (or you choose "Cancel 
File Send" from under the File menu, the temporary text file is destroyed. 


Th n An lear Command 

Under the Edit menu, the Undo and Clear commands are not used by Red 
Ryder. They are there to support those desk accessories which make use of 
these commands. 


ing Th nt Text Is Displ Wit 
You can choose which font and point size text in the Text Display Area is 
displayed by choosing Set Font under the Local menu. Red Ryder will let you 
choose any installed font when you are emulating a TTY terminal, but when you 
are emulating either a VT52 or VT100 terminal, you may use only the 
TTY-VT52-VT100 font (although you may select either 9 or 12 point size for this 
font). 


Red Ryder will allow you to use only font sizes that are installed in the System 
Folder of the startup disk. 


Tab Stops 


When in the course of displaying text Red Ryder receives a tab control 
character, it will interpret this to mean "print spaces up to the next tab stop or the 
end of the current line." By choosing Tab Stops... from under the Local 
menu, you can specify at which columns to place tab stops. 


When this command is chosen, a dialog box as shown below is displayed on 
your screen: 


Sees Tab Stops ======== 


a : Serpent ates aval atas DI HT 
` te * H ewes abate ="... 
ETETETT H 





The dialog box contains a column ruler, with small black circles showing where 
tab stops are located. To set a tab stop, just point your mouse at the desired 
column in the ruler and click - a small black circle should appear. To remove a 
tab stop, just point at the column in the ruler containing a small black circle and 
click. The horizontal scroll bar above the ruler can be used to show columns 
not currently displayed in the ruler. 
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There are two important things to remember about tab stops. First, just because 
you place your tab stops in certain positions does not mean that the remote 
machine has agreed (or even knows about) these positions. It's similar to 
taking a typed report from one typewriter in your office and putting it in a second 
typewriter. If you are capturing (or archiving) the text on the screen, you will 
probably have to set the tab stops again once the file is loaded into a text editor 
or word processor. 


Secondly, Red Ryder's tab stop ruler is based on columns, whereas many word 
processors base their tab stops on inches (or centimeters). Therefore, if you are 
using a proportionally spaced font (where some characters are wider than 
others), don't be alarmed if columnar data doesn't line up on the Red Ryder 
screen. If you will be receiving columnar data, | suggest you use a monospaced 
font (where all characters are of equal width), like the Monaco or 
TTY-VT52-VT100 fonts. 
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Serial Port Settings 


A modem is a device that works with a computer in the same manner as a 
telephone handset works with your head. Both of these translate the original 
communications media (for humans: sound, for computers, digital electronic 
signals) into the bleeps and blorps that the telephone lines are capable of 
carrying. The receiving handset or modem then retranslates the bleeps and 
blorps back into voice or electronic signals. 


Consider a telephone conversation between people. Both persons must (either 
implicitly or literally) agree to speak in a language both participants understand, 
and a certain degree of etiquette (or protocol) must be followed throughout the 
conversation (such as not hollering wildly at the same time). Using computers 
and modems is very much the same. 


The first thing you must know before calling another computer is what language 
it expects you to use. For computers, we refer to this language as the 
communications protocol. If you set up your computer to use a different protocol 
than the computer you call uses, you'll either get "garbage" characters on your 
screen or nothing at all. Sooner or later, one of you will get frustrated and hang 


up. 


Communications protocol can be divided into several components. We call 
each component a parameter. Each parameter must be set up correctly to 
communicate properly. 


Baud Rate - this is how quickly the computers are capable of "speaking" to 
each other. The choices Red Ryder offers are 300, 450, 1200, 2400, 4800, 
9600, 19200, and 57600 baud. 


Parity - This is a simple form of error checking. Red Ryder supports NO Parity, 
ODD Parity, EVEN Parity, MARK Parity, and SPACE Parity. 


Data Bits - This size of each character. Red supports 5, 6, 7, and 8 data bits. 


Stop Bits - Additional signals sent at the end of each character transmitted. 
Red supports 1, 1.5, and 2 stop bits. 


Duplex - This is the "etiquette" we spoke about earlier. Red supports FULL 
Duplex, HALF Duplex, ECHO Duplex, and NULL Duplex. HALF Duplex is what 
some users refer to as "local echo", and should not be confused with ECHO 
Duplex. ECHO Duplex will never be used by both callers at the same time, and 
is only used by Red Ryder when it is acting in a host capacity (see the chapter 
on the Host Mode for more details). 


Duplex controls what Red Ryder does with the characters you send. When you 
are using FULL Duplex, the characters are sent directly through the serial port. 
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FULL Duplex is used when the remote machine will echo back the characters 
you type. When you are using HALF Duplex, Red Ryder not only sends the 
characters you type through the serial port, but also to your display screen. This 
is used when the remote machine does not echo back the characters you type. 


ECHO and NULL Duplex are provided for special cases. ECHO Duplex 
functions like HALF Duplex, except that it also echoes back any characters 
received (much like a remote machine would when you are using FULL 
duplex). ECHO duplex is provided for when you are using Red Ryder in a host 
capacity (see the chapter "Host Mode" for details). NULL Duplex also acts like 
HALF Duplex by sending the characters you type to your display screen, but it 
does not send those characters over the serial port. NULL Duplex is used 
mainly for local testing purposes. 


You'll need to contact the operators of the computer you'll be calling (or consult 
the documentation that describes the service) to find out how to set up these 
parameters. There will be times, however, that this is not practical or possible. 
In this case, you'll have to resort to an educated guess. This isn't as hard as it 
sounds. 


| recommend that the first time you call that you use 300 baud. It is the lowest 
common denominator, as well as the slowest standard speed used. Once 
connected (or "online", as we in "the biz" say), you can find out if the service 
supports a faster baud rate. 


Next, let's talk about duplex. Most professional computer services and bulletin 
board services (BBS's) will echo back the characters you type so they'll display 
on your screen. For this reason, start out with FULL duplex. If you can't see 
what you're typing, switch to HALF duplex. If you are using HALF duplex and 
see double characters ("HHEELLLLOO"), switch to FULL duplex. 


Pretty easy so far, eh? This leaves only 3 parameters (Parity, Data Bits, and 
Stop Bits) with "billions and billions" of combinations. Not to worry, only a few 
combinations are used by 99% of the systems out there. The other 1%, of 
course, were put on this earth just to frustrate documentation writers who try to 
make things easy for beginners. 


The first time you call a system, use NO Parity and 8 Data Bits. If you get 
"garbage" characters or the other computer does not respond at ail, wait a few 
seconds and then type the "RETURN" key a few times and see if that helps. If 
you still have no luck, hang up, set your parameters to EVEN Parity and 7 Data 
Bits, and call back. Most likely, one of these two settings will work. If not, you're 
out of luck as far as an educated guess is concerned, and will have to get the 
information from the operators of the system. You will probably never need to 
fool with Stop Bits, just set it to "1" and forget about it. 


Red Ryder does not "know" what, if anything, is connected to the serial port. 
Whatever you type at the keyboard is sent through the serial port. If characters 
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are received through the serial port, they are displayed as appropriate in the 
terminal window. Therefore, you can send your modem's particular commands 
(such as for auto-dialing) just by typing directly to the modem. Because Red 
Ryder is designed to support any modem that can be hooked up to a Macintosh, 
we do not discuss in detail the methods that are specific to various modems for 
such things as dialing and hanging up in this document. You do need to read 
through the manual that came with your modem to exploit its capabilities with 
Red Ryder. 


The vast majority of Red Ryder will be using "Hayes compatible" modems that 
support the Hayes Smartmodem "AT" command set at least to some degree - 
we have found that some manufacturers (including at least...ahem...one major 
computer corporation) have used the term "compatible" rather liberally. The 
manual that came with your modem will go into more detail, but we can serve 
up a few basic pointers here to get you started. 


ndin mmands To The M 
Before sending any dialing commands to the modem, you should make sure the 
modem has recognized the serial port settings you are using. To do this, type 
the letters AT and press the Return key. Some modems will let you get away 
with lowercase letters, others demand all capital letters. 


If everything goes well, the modem will respond by sending the word "OK" to 
Red Ryder, which will be displayed on the screen. If it doesn't, try sending the 
AT command a couple of more times before giving up. 


The AT command is used to get the modem's attention. It doesn't have to be 
sent before every modem command, but it should be used immediately after 
starting up Red Ryder, and each time after you change the serial port settings. 


Dialing A Number 

If you are using a touch-tone telephone, the modem dialing command ATDT is 
used. If you are using a pulse telephone, the modem dialing command ATDP 
is used. Follow the dialing command with the number you wish to dial, like this: 


ATDT 555-1212 (press Return) 

The hyphen in the above command is ignored by the modem. You can 
introduce a pause during dialing by inserting a comma in the number to be 
dialed. The dialing command: 

ATDT 9,555-1212 

would dial a 9, wait 2 seconds, then dial 555-1212. Pauses are useful when 
you need to get an outside line through a switchboard. You can string more 


than one comma together for longer pause durations (in increments of two 
seconds). 
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Hanging Up The Modem 

When your modem connects with another modem, it goes into a characters 
pass-through mode, which means that it leaves the command mode and passes 
through the characters you type to the other modem. To get back in command 
mode in order to disconnect, you need to: 


1) Wait at least three seconds since the last character you typed. 

2) Type three plus signs quickly (don't press Return). 

3) Wait a few seconds and the modem should come back with the message 
"OK", 

4) You're now in the command mode. Type the modem command ATH and 
press Return. The modem should disconnect from the phone line. 


Telling Your Modem To Answer An Incomin all 

The command ATS0=1 (that's a zero) is used to tell the modem to answer an 
incoming call on the first ring. The command ATS0=0 tells the modem never to 
answer the phone. If you forget to set the modem to auto-answer mode and 
have an incoming call (you get "RING" messages), you can teil the modem to 
immediately take the phone line off hook and attempt to connect with the caller's 
modem with the command ATA. 


Armed with your modem manual and the information in this chapter, you should 
have all you need to try and connect with a remote machine for the first time. 


The DTR Modem Line 


On the newer Macintosh models with the round 8-pin serial port connector, a 
special output handshake line is provided. This line is typically connected to 
the RS-232 signal line designated as DTR (Data Terminal Ready). 


When the signal on the DTR line is "dropped", many modems will automatically 
disconnect (hang up) the phone line. Local Area Networks may use the DTR 
line to signal connection. 


In the dialog box presented by the Change Serial Port Settings... 
command, if the choice Don't drop DTR when exiting Red Ryder is 
selected, the connection will not be dropped when you exit Red Ryder, and you 
should be able to return online by executing Red Ryder again. If this choice is 
not selected, the DTR line will be dropped when you quit Red Ryder. 


If you click in the Drop DTR For 1 Second button, the DTR line will be 
dropped for one second, which may be useful for signaling a Local Area 
Network or modem equipped PBX system. 


Neither of these settings will have any effect unless the RS-232 DTR line is 
connected to the output handshake pin of the serial port Red Ryder is 
communicating through, or if the device connected to the serial port is instructed 
to ignore the state of the DTH line. 
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The General Status Bar 


To select the General Status Bar display, choose General Status Bar from 
under the Local menu. The General Status Bar is composed of six different 
control areas. From left to right: 


« The Elapsed Time And Billing Clocks: 


e The Display Screen To Printer button: 





m 
[P 


« The Display Screen To "Archived Screens" File button: a» a 


: . ; Serial Port Settings 
* The serial port settings display: RE e 


* The Pause/Resume Remote Button: Remote 


+ The Control Character Buttons: (s) C 


"D 
= 
- A 
(D 


The Elapsed Time And Billing Clocks 

The Elapsed Time And Billing Clocks are used to keep tabs on how long you've 
been connected, and how much money you've spent so far. To reset the clocks 
back to 00:00:00 and $0.00, click in the box containing the clocks. 


You can calibrate the billing clock to the desired charge by selecting Set 
Billing Cost... from under the Service menu. This will display a dialog box 
prompting you to enter the cost per minutes in 100ths of acent. In other words, 
if your service charges you $5.00 per hour, you would divide 500 cents by 60 
minutes to get 8.33 cents per minute. Divide 8.33 cents by 100 to get 833, 
which is your cost per minute in 100ths of a cent. This may seem a little 
convoluted at first, but by specifying the cost per minute in 100ths of a cent, the 
Billing Clock offers a reasonable degree of precision. 


The Display Screen To Printer Button 
Clicking in the Display Screen To Printer Button will send the lines of text in the 


Terminal Display Window to the printer. For details in setting Up and using a 
printer with Red Ryder, see the chapter "Using A Printer With Red Ryder”. 


The Send Screen To "Archived Screens" File Button 

Clicking in the Send Screen To "Archived Screens" File button is equivalent to 
choosing the Archive Display Screen choice under the Local menu. This 
menu command is described in detail in the chapter "The Terminal Display 
Window'. | 
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The Serial Port Settings Display 

The Serial Port Settings Display shows you at a glance what baud rate, parity, 
databits, stopbits, and duplex is being used by the serial port Red Ryder 
communicates through. Clicking in this box is equivalent to choosing Change 
Serial Port Settings... from under the Local menu. Serial port settings are 
discussed in detail in the chapter “Serial Port Settings". 


The Pause/Resume Remote Button 

The Pause/Resume Remote Button is actually two buttons, "Pause Remote" and 
"Resume Remote” which toggle back and forth each time you click on them. 
Clicking the "Pause Remote” button will send a CTRL-S (also known as XOFF) 
control character, which many host machines understand to mean “stop 
transmitting”. 


Clicking on the "Resume Remote” button will send a CTRL-Q (also known as 
XON) control character, which many host machines understand to mean 
"resume transmitting". 


The use of CTRL-S and CTRL-Q to start and stop transmission is known as 
XOFF/XON handshaking. It's not guaranteed that every host machine you'll 
connect with will support XON/XOFF handshaking, but the vast majority should. 
Let's say you are connected to a host at 1200 baud and it is displaying some 
text you are interested in. Unless you're a much faster reader than the average 
bear, text will probably start scrolling off the top of your screen before you can 
finish reading it. When this happens, click on the "Pause Remote" button and 
the remote machine should stop transmitting. When you're caught up, click on 
the "Resume Remote" button and the remote machine should resume 
transmitting. This button makes it easy to start and stop the host by positioning 
the mouse over the Pause/Resume Remote Button and clicking your mouse to 
throttle the transmission to a more comfortable speed. 


Th ntrol Character Button 

The Control Character Buttons can be modified to send any control character 
you wish by selecting Edit Control Buttons... from under the Edit menu. 
These buttons simply send the displayed control character when you click your 
mouse in them. They are useful for when your hand is on the mouse rather than 
the keyboard, or when certain control characters are needed but not readily 
available on the keyboard. 
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Keyboard Specifics 


Red Ryder uses the keyboard in such a manner to support all of the functions 
commonly used in telecommunications. Red Ryder will automatically adjust to 
either of two keyboards, the standard keyboard, which was shipped with the 
original 128K and 512K Macintoshes and could be configured with an optional 
numeric keypad, and the Macintosh Plus keyboard, which was shipped with 
the Macintosh Plus and has a built in numeric keypad. 


These two keyboards represent the vast majority of those in use at the time of 
Red Ryder's release. However, | am certain that radically different keyboards 
will be shipped for use with newer Macintosh models. This will have an affect 
only on the VT100 keypad emulation, and a special "Install VT100 Keypad" 
utility program has been created in anticipation of physical alterations to the 
keyboard. 


Red Ryder has the capability to support many different needs as far as special 
keys are concerned. Because there several keys found on other computers and 
terminals that are not found on the standard and Macintosh Plus keyboards, 
Red Ryder gives you the ability to "map" the keyboard to your special needs. 
Browse through this information right now so that you know it exists. Chances 
are you may never have to adjust Red Ryder's default settings unless you use 
VT100 or VT52 terminal emulation, or communicate with a host that falls into the 
"oddball" category. 


In the following descriptions, we will refer to the key with the cloverleaf symbol 
on it as the "Command" key. 


Under the Customize menu, there is a Keyboard Mapping Preferences 
choice that brings up a dialog box with the following items: 

°" key sends "x" (where "x" is a value from 0 to 255) makes the right pointing 
accent (which is at the top left corner of the keyboard) send whatever character 
you wish. For instance, to make this key send an ESCAPE, you would enter 
the value 27 (which is the ASCII code number for ESCAPE). Note that there is 
not a way (except through a macro key) to send a right pointing accent 
character when this option is selected. 


If the Backspace key is DEL key choice is enabled, the Backspace key will 
send a DELETE control character (ASCII code 127). Otherwise it will send a 
normal backspace contro! character (ASCII code 8). If your Backspace key 
doesn't seem to work right, check the state of this choice. 


If the Modem BREAK signal keys supported choice is enabled, the 


keyboard combination Shift-Backspace will send a short (233 millisecond) 
modem BREAK signal (if your modem supports it). The keyboard sequence 
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Shift-Command-Backspace will send a long (3 1/2 - 4 second) modem BREAK 
signal. | 


If the VT100 cursor key diamond supported is enabled, you can simulate 
the VT52/100 cursor keys with the following Macintosh keyboard combinations: 


Macintosh K rd Acti Sends: 
Command-Backspace Same as VT100/52 "up" 
| cursor key. 
Command-Return Same as VT100/52 "down" 
cursor key. 
Command-\ Same as VT100/52 "right" 
| cursor key. 
Command-] Same as VT100/52 "left" 
cursor key. 


This feature will probably be only useful with the standard Macintosh keyboard 
which does not have a numeric keypad attached. This gives you a set of cursor 
keys on the keyboard arranged in a diamond shape. 


The Control characters are sent with choice allows you to choose one of 
two keys that can be used to send control characters. In addition to the normal 
A-Z alphabet and punctuation characters we use in normal written 
communications, there are many additional characters significant in 
communicating by computer. What they are and how they are used is really up 
to each individual service you'll connect with. Many are standard, but don't bet 
your last dollar that any or all will be recognized until you've read the service's 
documentation or have had a chance to experiment. Often, the correct 
characters to press will be displayed on your screen by the remote service at 
various times, like: 


Press CTRL-S to pause, CTRL-Q to resume, or CTRL-C to quit. 


The "CTRL", by the way, is a common abbreviation for "control". A control 
character is used for various commands to the remote service. A 'C' anda 
CTRL-C are two different characters and should not be confused or used 
interchangeably. 


Since the early Macintosh keyboards were not provided with a "Control" key, an 
interesting dilemma confronted me while writing Red Ryder. The Command 
(cloverleaf symbol) key was a logical replacement for the Control key, but the 
user would have to give up Command key menu choice equivalents (which 
many users favor over the mouse in certain situations). If the OPTION key were 
used international characters could not be directly typed. 


Perhaps it is wishy-washy, but it has been decided that the decision should be 


made by the user, on the basis of personal preference and need. Therefore, the 
Keyboard Mapping Preferences dialog box allows you to decide whether 
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to use the Option key or the Command key to send control characters. If the 
Command key is chosen, the menu/key equivalents are not displayed or 
supported in Red Ryder's menus. Otherwise, they appear in the menus and can 
be used as shortcuts for menu choices. The NULL contro! character (ASCII 
code 0) can be sent by holding down your designated Control key (Option or 
Command) and pressing the Spacebar key. To send a control character 
(CONTROL-A to CONTROL-Z is ASCII code 1 to ASCII code 26), you hold down 
your designated CONTROL key and type the desired letter key. 


The Command and Option keys are used like a Shift key. To send a 
CONTROL-A, you would press and continue to hold down the designated 
Control key and then type the character "A". i 


In this documentation, and in some character strings used by Red Ryder, we 
designate a control character by preceding it with a caret (^) symbol. Some of 
the control characters you're likely to run across frequently are: 


ASCII Key Typical Use 
^C 


3 Usually means "interrupt this function" 

7 ^G Sound a "BELL" or beep 

8 ^H Same as your Backspace key 

9 di Same as your Tab key 

10 ^J A linefeed character 

12 "L Clear the screen or form-feed the printer 

13 AM Same as your Return key 

17 AQ XON character, tells other computer to resume 
transmission after an XOFF. 

19 ^5 XOFF character, tells other computer to halt 


transmission until an XON is received. 


The Return key sends: option lets you choose whether the Return key sends 
just a carriage return, or a carriage return followed with a linefeed character. If 
the characters you type appear perfectly on your screen but the host system 
does not respond when you press the Return key, or lines seem to overprint 
each other when you press Return, chances are the remote system probably 
requires an additional character after the carriage return called a linefeed 
character. Don't select this option indiscriminantly, some host systems will not 
function correctly if this option is turned on. 


If you have an Apple numeric keypad connected to your standard Macintosh 
keyboard, or a Macintosh» keyboard with the numeric keypad built in, its keys 
will function exactly like those on a VT100 keypad when VT100 or VTS2 
emulation is active. The keys are mapped like this: 
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uama 
noon HEGE 


E E 
| Leleh 
T T 
E E 
R R 
Normal Option key pressed 


Because many VT100 applications map special keys to the above physical 
arrangement, it was my decision to map the VT100 keypad in its original 
alignment, rather than according to the characters physically printed on the 
Macintosh key caps. 


If a Macintosh Plus keyboard is used, the cursor keys at the bottom right corner 
of the keyboard are automatically supported. | 


If you are using a non-U.S. keyboard, or are using a newer keyboard than that 
supplied with the Macintosh Plus (like the ones shipped with Macintosh SE and 
Macintosh Il machines), you may find that some of the special VT100 keys don't 
work as documented above. Don't despair, you can adapt Red Ryder to any 
keyboard once you've read the chapter "Redefining The Standard VT100 
Special Keys". 
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The Buffered Keyboard 
Status Bar 


The Buffered Keyboard Status Bar was added mainly for use with the real time 
conferencing features of several commercial timesharing services like 
CompuServe, GEnie, and Delphi. A real time conference is where two or more 
(sometimes several dozen or even hundred) people get together and type to 
each other in a CB-radio fashion, exchanging opinions, tips, bad jokes, etc. The 
value of the Buffered Keyboard Status Bar is that it gives you the opportunity to 
correct mistakes (or obscene punch lines) before sending them, and it sends 
the characters typed all at once, so that even the slowest typist doesn't hamper 
the faster typists in the crowd. If you take advantage of real time conferences (I 
suggest you do - they can be very educational and a lot of fun), you'll find the 
Buffered Keyboard Status Bar indispensable. 





To display the Buffered Keyboard Status Bar, select Buffered Keyboard 
Status Bar from under the Local menu. Whenever the Buffered Keyboard 
Status Bar is displayed, the characters that you type are not sent to the serial 
port immediately, but are instead held in an editable buffer until the Return key 
is pressed. When that happens, the characters are "flushed" out of the buffer 
through the serial port all at once. 


The exception to this is that all control characters, except tabs and carriage 
returns, and characters from sources other than the keyboard (such as Macro 
Key Strings, VT100 Status Bar keys, and Procedure TYPE commands) are sent 
immediately through the serial port without effect to the buffer. It is not possible 
to put control characters in the buffer. Tabs are expanded as spaces (according 
to where you have tab stops set) just as inside the Text Display Area. 


The text inside the buffer is editable, which means it can be selected with the 
mouse, and then cleared, copied, or cut to the Clipboard. To use the Cut, 
Copy, Paste, and Clear commands under the Edit menu with the buffer, hold 
down the Option key when selecting the desired command from under the Edit 
menu. The command must be selected from the Edit menu with the mouse - 
keyboard menu command equivalents won't work for this. 


For example, holding down the Option key and selecting Paste from under the 
Edit menu tells Red Ryder to paste the contents of the Clipboard to the buffer, 
rather than directly to the serial port. 


Some services have a limit of how many characters you can type before 
sending a carriage return. Exceed that line length limit, and the service will 
probably choke, send you an obscure error message, and throw away what you 
typed into oblivion. For this reason, Red Ryder supports a modifiable right 
margin for the Buffered Keyboard Status Bar that it won't let you type past. fo 
change the position of this margin, the dialog box brought up by the Personal 
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Preferences choice under the Customize menu contains the choice 
Buffered keyboard right margin limit. If the right margin is set to greater 
than 80 columns, the horizontal scroll bar above the buffer is activated to allow 
you to scroll left and right for viewing all of the characters in the buffer. 


You'll also notice that to the left of the horizontal scroll bar, your current right 
margin column and the number of characters in the buffer is displayed. As you 
type past the right edge of the buffer, the buffer is automatically scrolled left for 
you so you can keep your eyes on what you're typing. Once you hit the right 
margin, a bell is sounded and no more characters will be accepted until you 
either delete one or more characters, or send the contents of the buffer by 
pressing the Return key. 


The characters in the buffer are always displayed in Red Ryder's 
TTY-VT52-VT100 font at 9 point size. 
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The Macros Status Bar 


The Macros Status Bar is displayed by selecting Macros Status Bar from 
under the Local menu. It is composed of three control areas, from left to right: 





« The Macro Key Buttons: 


Call Delphi E ` — | [Collect Mail | 


s. 


| Hang Up! E 







j Call Mau 


EST De 


Call GEnie | Call BIX ES 














* The Set Selection And Display Control: 


01:42:49 


* The Elapsed Time And Billing Clocks: $8.49 


Bi INI 


The Elapsed Time And Billin lock 

The Elapsed Time And Billing Clocks operate exactly like their counterparts in 
the General Status Bar, and are described in the chapter "The General Status 
Bar". 


What Is A Macro Key? 
Once you've started using various services regularly, you'll find that you'll be 


typing many of the same words and commands over and over. Macro Keys are 
used to send up to 40 characters of your choice with only one keystroke or 
mouse click, or they can be used to quickly execute a compiled Procedure File. 
There are 30 Macro Keys, divided into 3 Sets of ten Macro Keys each, which we 
refer to as Set #1, Set #2, and Set #3. Each of the three Sets contains Macro 
Keys numbered 0 to 9. A Set containing a Macro Key must be active before 
that Macro Key can be executed. You know that a Macro Key Set is active 
when its Set number is shown in the middle of the Set Selection And Display 
Control - in the above illustration, Set 42 is active. To make a different set 
active, click in the arrows in the Set Selection And Display Control. The new 
active set will scroll into view and its Set number will be displayed in the middle 
of the Set Selection And Display Control. 


In the Macros Status Bar, the top row of Macro Key Buttons contains buttons #0, 
#1, #2, #3, and #4. The bottom row contains Macro Key Buttons #5, #6, #7, #8, 
and #9. 


To execute a macro key, you hold down the COMMAND key and type a numeral 
from 0 to 9 corresponding to the Macro Key you wish to send (i.e. type 
COMMAND-1 to execute Macro Key #1 in the currently active Set), or click in 
the corresponding Macro Key Button in the Macros Status Bar. 


Each Macro Key consists of two different strings of characters, the macro key 
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label and the macro key string. The label is used to remind you what the 
Macro Key does. Macro Keys become visible in the Macros Status Bar when 
they have a label. If the label is empty, the Macro Key Button is not displayed in 
the Macros Status Bar and is not selectable with the mouse. 


To store characters inside a macro key label or string, select the Edit Macro 
Keys choice from under the Edit menu. You'll first see a dialog box asking you 
to specify which set and macro key number in that set to edit. Clicking in the 
Erase All button will erase all Macro Key Labels and Macro Key Strings. After 
choosing the set and key number, you'll see a new dialog box with two editable 
text boxes. The top box is titled "String:” and it contains the actual characters 
you wish that macro key to send, or the file name of the compiled Procedure File 
to execute. The bottom box is titled "Label:", and it contains a "name" you wish 
to give to that key. The label can be up to 13 characters long, and the characters 
are shown centered in the Macro Key Button. 


A carriage return character is not automatically sent at the end of a macro key 
string. However, it just so happens that there is a way to embed control 
characters in a macro key string, and there is a certain control character that is 
the same as what your RETURN key sends. This control character is CTRL-M. 
You specify control characters by preceding it with a caret character, like “M for 
CTRL-M. To send a caret character, type in two carets side by side (^^). 


Here's an unlikely (but illustrative) example: 

HELLO^ETHERE^BOB^M 

This example would send the characters "HELLO", followed by a CTRL-E, 
followed by the characters "THERE" followed by a single caret character, 
followed by the characters "BOB", followed by a carriage return (which is the 
same a CTHL-M). 


If the above makes perfect sense, you're in good shape. Otherwise, you need 
to go back and review the last few paragraphs until it is clearer. 


For the most part, the only control character you'll probably need to ever use in 
a Macro Key is CTRL-M for carriage returns. Just remember that: 


HELLO THERE^M 
would send a carriage return at the end of "HELLO THERE”, and: 


HELLO THERE 


would not. For those of you who have found the need to send linefeeds after 
carriage returns, your "magic" sequence becomes: 
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HELLO THERE^M^J 


Macro Keys are useful for holding passwords, commonly used commands, and 
even quick and dirty modem dialing commands. If you have a Hayes 
compatible modem you could set up a Macro Key that contains: 


ATDT 555-1212^M 


When you sent that Macro Key, it would issue the appropriate dialing command 
to dial touch-tone the number 555-1212. Please change that number before 

. experimenting or you'll have a Directory Assistance operator who thinks they 
have a “breather” on the line while you're busy celebrating success. 


Remember that each Macro Key String can only hold 40 characters, including 
any caret characters. If you try to enter more than 40, the surplus will be “lopped 
off" into oblivion. So there. 


Later on you'll learn about a programming language contained in Hed Ryder 
which can be used to write something called a Procedure. Procedure Files are 
used to completely automate a portion of, or even an entire online session. If 
the first character of a Macro Key String is a backslash (which is not to be 
confused with the slash ("/") character) Red Ryder will use the rest of the 
characters in the Macro Key String to be the file name of a Procedure file you 
wish to execute immediately. No characters are sent through the serial port by 
the Macro Key itself when used in this manner. This is a much faster way of 
executing frequently used Procedures than going through the Initiate 
Procedure... menu command and then navigating through disks and folders 
to find the Procedure File you wish to run. 


tn other words, if the Procedure File named CALL COMPUSERVE is located on 
the disk named PROCEDURES, you would need to set up the Macro Key String 
to read: 


\PROCEDURES:CALL COMPUSERVE 


The colon character is what separates the volume and file names. 


One of the most common problems in using Macro Keys to execute Procedure 
Files is getting the file name of the Procedure File correct. Bad spelling aside, 
the Macintosh allows you to have leading and trailing spaces in front of disk, 
folder, and file names, and these spaces must be present in the Macro Key 
String or else you'll get a "Procedure File Not Found" error. In other words, 
unless you have X-ray vision, it can be real difficult to get such file names 
correct. For this reason, instead of typing in a file name, use the Get 
Procedure File button provided in the dialog box. When clicked, you will be 
presented with a standard file selection dialog box and prompted to select a 
Procedure File. Once a Procedure File is selected, Red Ryder will construct a 
valid path name to the file and insert it in the Macro Key String (complete with 
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the leading backslash character). 


You'll soon find that even 30 Macro Keys just aren't enough for your ever- 
growing sophisticated needs. Red Ryder allows you to save your Macro Keys in 
a disk file to be loaded in at a later date. Simply choose the appropriate choice 
Save Macro Keys To Disk or Load Macro Keys From Disk from under 
the Customize menu to accomplish this. 


You can also use macro keys to set up special escape-code command 
sequences used by VT52 and VT100 applications. To send an ESCAPE 
control character, use the sequence "^[" (caret-left square bracket). 


Red Ryder can also accept certain other sequences of characters in a Macro 
Key String to perform special functions: 


Sequence Function 
A$ Sends a DEL character (ASCI! code 127) 
2] Sends a short modem break signal 
ÑO Sends a long modem break signal 
^i Drops the DTR serial port line for 1 second 


These sequences don't have to appear alone, they can be embedded within à 
Macro Key String's characters. 
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The VT100 Status Bar 


The VT100 Status Bar is used for two purposes: 


* To display the condition of the four LED's (small lights) found on an actual 
VT100 terminal, but not on a Macintosh. 

« To allow Macintosh owners that do not have a numeric keypad to simulate PF 
keys, cursor movement keys, and numeric keypad keys found on actual VT52 
and VT10O terminals. 


The VT100 Status Bar is only used when you are emulating a VT52 or VT100 
terminal (see the chapter "Terminal Emulation Specifics" for more details). It 
has no function when you are emulating a TTY terminal. To display the VT100 
Status Bar, choose VT100 Status Bar from under the Local menu. The 
VT100 Status Bar is divided into three control sections: 


* The PF keys and LED display: a — mE 
BE AN] 
* The cursor movement keys: —+ 
* The numeric keypad keys: Site FE^ oer bis 


With the exception of the four LED's and the two blank boxes surrounding the 
up cursor movement key, clicking your mouse inside any of the boxes is 
equivalent to pressing the same key on an actual VT52 or VT100 terminal. If the 
VT100 Auto-repeat mode is set (VT100 modes are discussed in the "Terminal 
Emulation Specifics" chapter), the keys in the VT100 Status bar will repeat as 
long as the mouse button is held down inside them. 


The two blank boxes surrounding the up cursor movement key are not used and 
will just beep at you if you try to select them. 


The four LED's L1, L2, L3, and L4 will be shown as white characters on a black 


background when they are "lit". In the above illustration, L2 and L4 are "lit", 
while L1 and L3 are not "lit". 
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Redefining The Standard VT100O 
Special Keys 


As discussed in the chapter "Keyboard Specifics", the VT100 special keys not 
found on all Macintosh keyboards (specifically, the cursor movement keys, PF1 
through PF4 keys, and numeric keypad keys) are automatically mapped for the 
keyboards shipped with the original Macintosh 512K and Macintosh Plus 
computers. 


It has become apparent that Apple will ship at least two additional keyboards for 
use with the Macintosh SE and Macintosh ll machines, and it would be unwise 
not to anticipate down the road that there will be more keyboard variations than 
this author has bad habits (those who have met me in person will attest that my 
ahem...eccentricities... can be counted only with the help of scientific notation). 
This, coupled with the fact that there already exist several international 
keyboards that have different physical (and sometimes logical) key 
arrangements led me to address this problem with an all-purpose special key 
remapping utility. This utility, found on the Red Ryder master disk, has an icon 
that looks like this: 


Install Keypad 


Please recognize that this utility is provided only for the 
special cases that require it. Those who are using Apple 
keyboards shipped with the Macintosh 512K or Macintosh 
Plus will not normally need to use this program. 


The Install Keypad utility is used to install special key mapping information in a 
Settings File. When this application is first executed, you will be prompted to 
select a Settings File to modify with the new key mapping information. Once 
you have done this, the a dialog box is displayed that contains the following 
graphic depiction of the special keys that can be remapped: 
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These keys are grouped for illustration purposes as they are grouped on an 
actual VT100 keyboard. You can choose to assign their functions to anywhere 
on the keyboard. To remap a key, just click your mouse button with the cursor 
pointed inside the key to be remapped in the picture. A new dialog box will 
appear asking you to type the key on your keyboard that will correspond to the 
remapped key in the picture. As you type this key, remember that the Option, 
Shift, and cloverleaf keys are significant, and will have to be supplied in the 
correct combination ("Shift-Option-Cloverleaf-X" would be a proper key 
definition) later to get this key function. 


The following is important so please read it carefully. When you remap keys 
using the "Install Keypad" utility, it does not make any changes to the chosen 
Settings File until you click on the Install Special Keys button. Therefore, if 
you go through and specify a complete redefinition of these keys and the click 
on the Quit button without first clicking on the Install Special Keys button, 
none of your changes will actually be saved in the Settings File. 


If you later change your mind about the remapping and want Red Ryder to go 
back to its automatic keyboard recognition (of the earlier Macintosh keyboard 
models, that is), just start up the "Install Keypad" utility, choose the Settings File 
that you earlier modified with this utility, click on the Remove Special Keys 
button, and then click on the Quit button. 


The second important thing to remember is that whenever you click on the 
Install Special Keys button, it completely replaces all of the keys in the 
picture with the definitions you have stored. This means that if you run this 
application, remap only the cursor movement keys, and then click on the Install 
Special Keys button, the changes will be stored for all of the keys pictured. 
Until you define a key, it is given an "impossible" keyboard mapping. So, 
remember to remap all of the pictured keys with this utility, not just one or two, or 
you'll lose the ability to send the other pictured keys. 


The "Install Keypad” utility has a built in feature to help you keep track of which 
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keys have been given new definitions, and which still remain in limbo. Once 
you have clicked on a key in the picture and typed its new keyboard mapping, it 
will be displayed as a gray square in the special keys picture. The undefined 
keys will be shown with a white background. 


| make no apologies about the fact that the "Install Keypad” utility was a 23rd 
hour necessity brought on by machines | did not have access to during this 
software's development. As such, ! recognize that some improvements are 
immediately recognizable and will be addressed in future versions of Red 
Ryder. One of these is the fact that the Show Keypad Map button in the 
dialog box displayed by the VT100 Modes... menu choice is "blind" to 
changes made by the "Install Keypad" utility and may not reflect the physical 
remapping you have chosen. Therefore, | recommend that you write down the 
remapping of any keys that vary from the normal and keep that list handy for 
reference. 


It is a fact of software development that certain design considerations of a non- 
aesthetic nature (translation: it ain't pretty, but it works) are sometimes — . 
unavoidable if one is to assure a reasonable longevity for a piece of work. One 
does not decree the bizarre ruminations that may come out of Apple's keyboard 
engineering labs - one merely supplies the best profanity of their choice and 
sidesteps them. 


However, it may just so happen that this utility, in all of its user-ugliness, may 
provide a few additional solutions unintentionally. An example of this is a 
conversation | had with a fellow concerning a keyboard need he had for a 
particular mainframe/VT100 application he was tied to. The application in 
question used the "Linefeed" key almost exclusively, and the "Return" key 
hardly ever. His complaint therefore was that typing a CTRL-J (a linefeed) was 
awkward, and he really wished to remap the "Return" key as a linefeed key on 
his Macintosh Plus keyboard. After writing this utility, | found that this could 
easily be achieved with the "Install Keypad" utility. The icing on the cake is that 
since the Macintosh Plus keyboard defines a "Shift-Return" as the same thing 
as an unshifted "Return" keypress, he could remap the unshifted "Return" key as 
the "Linefeed" key, and then use "Shift-Return" for the seldom needed carriage 
return. 


Just remember that if you do something like this (just changing the function of 
one key), don't forget to remap all of the other pictured keys to their original 


mapping. 
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Customizing The Terminal 
Emulation 


Red Ryder has the capability to emulate several standard computer terminals, 
including a generic TTY (Teletype or like an electric typewriter) terminal, a 
Digital Equipment Corporation VT52 terminal, and a Digital Equipment 
Corporation VT100 terminal. While this may not make Red Ryder perform all 
things for all people, it does satisfy the requirements for the vast majority of 
general telecommunications applications. 


Under the Customize menu, the Terminal Emulation Preferences choice 
presents a dialog box containing the following options: 


* Display columns: Most terminals (and telecommunications programs) limit 
you to a small number of columns per line choices. Red Ryder allows you to 
choose any number of columns between 20 and 132 (inclusive). Some hosts 
will expect a standard line length (typically 40, 80, or 132 columns) and will 
format its sent text to reflect that length. However, if you are using an especially 
large font size and don't care much for a lot of constant horizontal scrolling, you 
may wish to reduce the line length. 


The size of the line length does not affect incoming text that is captured with the 
Capture Incoming Data To TEXT File... menu choice, which is to say that 
no additional carriage returns are placed in the file than what were sent by the 
remote machine. It will, however, affect where carriage returns are placed when 
you select a block of text using the mouse and then copy it to the Clipboard file 
using one of the commands under the Edit menu. 


. TTY Full-Screen Clears: As explained in more detail below, one of the 
control codes the TTY emulation supports is the "clear screen" (ASCII Code 12) 
command. When this control code is received, Red Ryder will clear the last 24 
lines of text received in the Terminal Display Window. You may, however, wish 
to keep that text around, in which case you should checkmark the Ignore TTY 
full-screen clears option so that these commands are ignored. 


Cursor style: This option does not affect the mouse cursor, but the small text 
cursor which shows you where the next received character will be displayed in 
the Terminal Display Window. Some people prefer a large block shaped 
cursor, in which case the Block option should be checkmarked, others prefer 
an underline shaped cursor, in which case the Block option should not be 
checkmarked. Additionally, you can decide whether you wish the cursor to flash 
constantly or remain solid by checking or not checking the Flashing option. 


. Terminal emulation: This is where you choose what sort of terminal Red 


Ryder should emulate in its operation. Unless you've been told otherwise or 
know better, | recommend you choose the TTY choice for an unknown system. 
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+ Serial port: The Modem connected to: option tells Red Ryder which 
serial port (the modem port or the printer port) you have the modem connected 
to. Red Ryder can use either port for modem communications, but Apple warns 
that at higher baud rates the modem port is safer. 


» Full-screen clears: Each type of terminal emulation has its own method of 
clearing all or part of the last 24 lines of text received. Clearing all 24 lines is 
known as a full-screen clear. Normally, a full-screen clear erases the 
cleared text into oblivion, but by checkmarking the Scroll up lines before 
full-screen clear option, you can have Red Ryder "push" the lines to be 
cleared up into the Saved Screens Buffer instead of just erasing them. If you 
are using TTY emulation, the Ignore TTY full-screen clears option must not 
be checkmarked in order for this option to work. 


- RLE Graphics: CompuServe (a large commercial host system), has the 
ability to send certain kinds of information (like radar weather maps or pictures 
of the FBI's Ten Most Wanted Fugitives) using either medium or high resolution 
graphics. Red Ryder supports both of these graphics modes (both are referred 
to as 'RLE' or 'Vidtex' graphics by CompuServe) if this choice is selected. If 
when you tell CompuServe to send a graphic item it displays a message to the 
effect that your terminal is not capable of receiving the graphics, just ignore that 
message and proceed. The graphics image will be displayed in a window of its 
own, and will be framed by a rectangle when the complete image has been 
received. Atthis point of Red Ryder's evolution, there isn't much you can do 
except admire the pretty picture. However, you can use the standard methods 
(pressing COMMAND-SHIFT-3 or COMMAND-SHIFT-4) to send the window 
display to a MacPaint compatible disk file or to the printer. This option should 
be turned off when you are not communicating with CompuServe. Because ofa 
control code conflict, it cannot be used with VT52 emulation. 
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Terminal Emulation Specifics 


Red Ryder can emulate three terminai types: a Teletype (TTY), a DEC VT100, 
and a DEC VT52. The type of terminal Red Ryder emulates is selected by the 
Terminal Emulation Preferences command under the Customize menu. 
Let's look at each of the terminal types and how Red Ryder emulates them. 


Terminal emulation defines how Red Ryder reacts to certain contro! characters 
sent by the remote system. TTY emulation, for instance, has a few very simple 
commands for clearing the screen, moving the cursor to the next ine, 
backspacing, tabbing, and sounding a bell. VT52 emulation adds several 
additional screen formatting controls, such as those to allow the quick 
placement of the cursor anywhere on the screen. VT100 emulation is the most 
advanced of the three, allowing such things as selective scrolling, character 
attributes such as boldface and underlining, and tab stop placement under host 
system control. 


TTY is what you should use the first time you call if you don't know what the 
remote system expects. If the remote system asks you to explain what terminal 
type you have and you don't see "TTY" listed, look for other descriptions that 
imply a non-specific terminal type, such as "CRT" or "OTHER". VT52 and VT100 
emulation is provided in Red Ryder mainly for those who are experienced with 
using the real thing, since no attempt is made to duplicate the VT100 or VT52 
User's Manual here. Those who are familiar with these terminals and their use 
should have little trouble adjusting to the emulation done by Red Ryder. 


VT52 Emulation Details 


The VT52 is emulated in the same manner a DEC VT100 operates in its "VTS2 
Compatible Mode". All of the emulation attributes are preserved, including the 
"Keypad Mode" (which can be set or reset manually by selecting the VT100 
Keypad Mode and VT100 Cursor Key Mode choices under the VT100 
Modes menu choice) and the special graphics character set. 


VT100 Emulation Details 





A lot of terminal programs purport to emulate a DEC VT100. | can guarantee 
that many don't even come close. From a programmers standpoint, doing a 
good VT100 is easy. Doing a very good VT100 is difficult. Doing a usable 
VT100 is so damn hard that it's rare. Every VT100 emulation has inherent 
deficiencies that you should be aware of. Rather than "forgetting to mention 
them", | think it's better to come right out up front and tell you exactly what you 
can expect. 


As much of the native VT100 environment as practical is emulated in Red 
Ryder. The functions not emulated will not be of consequence to the vast 
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majority of users, but are listed here as a matter of integrity. The functions not 
emulated include: | 


1) Double-high/double-wide and Single-high/double wide characters. Probably 
will be supported in a future version. 

3) Screen mode (inverse screen mode not supported). 

4) Interlace mode (hardware dependent - will not be emulated in future!). 

5) Blink character attribute (shown as inverse attribute). 


| recommend selecting Flashing Cursor with the Terminal Emulation 
Preferences menu command to help you easily locate the position of the 
cursor when it rests on top of a character having the inverse attribute. 


The VT100 terminal has several "modes" of operation that affect what 
characters the keypad and cursor movement keys send, as well as the 
appearance and function of the terminal display. Several of the VT100 modes 
can be manually set or reset through choices through the VT100 Modes 
command under the Customize menu. A mode is considered "set" when a 
checkmark appears in its dialog box choice. The choices in the dialog box this 
command presents are: 


Graphics Character Set Available - Red Ryder supports both the VT52 
and VT100 special graphics character set as well as the United Kingdom 
character set. Selecting this choice allows the remote computer to select and 
use them. 


VT100 Wraparound: When set, the cursor jumps to the beginning of the next 
line when it reachs the rightmost column. When reset, the cursor remains in the 
rightmost column and characters are overwritten in that column. 


VT100 Autorepeat: When set, most keyboard characters repeat continuously 
when held down. This includes the keys on the VT100 Status Bar. When 
reset, no keys are repeated. 


VT100 Cursor Key and VT100 Keypad: when set or reset, these modes 
affect the control codes that are sent for their respective keys. 


VT100 Newline: When set, a received linefeed character moves the cursor to 
the leftmost position of the next downward line. The RETURN key sends both a 
carriage return and linefeed character. When reset, the linefeed moves the 
cursor downward vertically only, and the RETURN key sends only a carriage 
return. 


Relative origin: this mode affects how cursor movement sequences are 
handled by the terminal. You normally should never have to touch this mode as 
the remote application should do it automatically. 


Smooth scroll: When set, the screen will scroll in a smoother fashion than 
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when it is not set. Although it is easier on the eyes, smooth scrolling is also 
slower than the normal scrolling. 


If you are not experienced with the consequences of the above modes, do not 
manually change them (unless the remote application specifically tells you to) 
without consulting the system operator of the remote system. The default 
settings should work with the majority of remote applications. If things work in 
strange ways upon starting up Red Ryder, the remote application probably 
didn't reset these modes properly. Try clicking your mouse in the Reset 
Terminal button to cause Red Ryder to return to the settings it had when first 
executed. 


If you forget how the numeric keypad is mapped during a session, just click in 
the Show Keypad Map button for a picture of the mapping. Note that this 
map is only guaranteed accurate for the original Macintosh 51 2K and Plus 
keyboards, not those supplied with the Macintosh SE, Il, or later models. Using 
the Install Keypad utility (described in the chapter "Redefining The Standard 
VT100 Special Keys") may also change the keypad mapping from what Is 
displayed with this button. 


You can also tell Red Ryder to respond to a certain control character sent by the 
remote computer (an ASCII code 5 (CTRL-E) for those who wonder) with a 
predefined string of characters known to VT100 users as the Answerback 
Message. This string may contain up to 30 characters, and may include 
control characters (such as a ^M for a carriage return) in a similar manner as 
they are included in Macro Key strings. 


The VT-Mouse™ 

You'll find that jack-hammering the cursor movement keys can be quite tiring 
and hard to follow. Since we've got a mouse on our Macintosh, let's use it! If 
you hold down your Option key when VT52 or VT100 emulation is active, you'll 
see that the mouse cursor turns into a small rectangle whenever it is moved into 
the text area of the display screen as shown in the following picture: 


people to come to the a 
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You'll find that this rectangle fits snugly around a character of text as shown 
above. Clicking your mouse will cause Red Ryder to send the appropriate 
series of cursor movement keys to move the cursor to that row and column. A 
great deal of time has been spent to make sure that this routine works as 
documented, but I've found that some VT100 editors use some very bizarre 
input throttling and cursor movement optimization methods. The heuristics 
incorporated into the VT-Mouse feature are as follows: 


If the "VT-Mouse waits for host" option is checkmarked: 


1) When you execute the VT-Mouse, it looks first at where the cursor currently is 
and then where it needs to go. It sends the proper cursor movement key codes 
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to move in the right direction towards the destination. 

2 ) It waits until the host sends the codes back to Red Ryder which mean "I got 
your request to move. OK, move itl". If this isn't received within 5 seconds, the 
VT-Mouse routine gives up. 

3) it looks at where the cursor is now and repeats this cycle until it gets to where 
you originally specified you wanted it to go. 


If the "VT-Mouse waits for host" option is not checkmarked: 


1) It looks first at where the cursor currently is and then where it needs to go. 
2) It sends all of the cursor movement codes needed to move directly to the 
desired ending location without waiting for the remote machine to respond. 


| suggest you checkmark the VT-Mouse waits for host option to start with. If 
it appears that the VT-Mouse is getting caught up in an endless loop, then and 
only then turn off this option. 


Even with this intelligence, it is still possible to overrun the host's ability to 
process the incoming cursor movement Keys. The symptom is a group of 
seemingly random "garbage" characters dumped in the middle of your text. The 
solution is to increase the VT-Mouse delay value in the VT100 Modes 
dialog box. This delay value ranges from 0 to 60. It specifies in 1/60th of a 
second increments how long to wait before sending the next cursor movement 
key. 


Overrunning can also be caused in some cases through the keyboard and 
VT100 Status Bar cursor movement keys. The solution is to slow down the 
keyboard repeat rate (in the Macintosh Control Panel desk accessory) and to 
use the VT-Mouse (with its added intelligence) rather than letting the VT100 
Status Bar cursor movement key buttons auto-repeat. 


The VT-Mouse feature is not guaranteed to work inside of all VT100 
applications. Think of it this way: if it works, hooray. If it doesn't, you're no 
worse off than any other VT100 user in the world. 


A Special Note About Fonts For International Users Ä 

When using TTY emulation, you can choose any font, and any point size that is 
installed on your Macintosh's startup disk. When using VT52 or VT100 
emulation, Red Ryder will allow you to only use the TTY-VT52-VT100 font, and 
then only in 9 point or 12 point size. This is for two reasons. First, Red Ryder 
uses the highest 128 characters of this font to hold the boldfaced versions of the 
normal character set as well as the VT52/VT100 special graphics characters 
set. Secondly, VT52 and VT100 emulations require a non-proportionally 
spaced font in either 9 or 12 point sizes. 


It is possible to use a different font than TTY-VT52-VT100 in conjunction with 
VT52 or VT100 emulation so that international, diacritical, and special 
characters can be used. The method for doing this is explained in the chapter 
"Using International Or Special Character Sets"). 
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Using A Printer With Red Ryder 


RED FLAG NOTE: If you are printing on cut sheet (rather than 
fanfold) paper, be sure to see the "Form Feed After X Lines” 
explanation below! If your printer does not respond at all to Red 
Ryder, make sure it has been installed properly with the Chooser 
desk accessory. 


Red Ryder can make full use of any printer connected to your Macintosh. 
Several commands use the printer directly: 


» The Echo Incoming Data To Printer choice under the Local menu. 

. The Print TEXT File... choice under the Local menu. 

. The Print Selected Text choice under the Edit menu. 

. The Send Display Screen To Printer button in the General Status Bar. 


The Send Display Screen To Printer button is discussed in detail in the 
Chapter "The General Status Bar" and the Print Selected Text menu 
command is discussed in detail in the chapter "The Terminal Display Window". 
Before we discuss the other two printing commands listed above, let's discuss 
how to set up the printer so that it will work correctly with Red Ryder. 


First, the correct printer resource file must be present in the System Folder of the 
disk used to start up the Macintosh. For example, the ImageWriter series of 
printers has its printer resource file named "ImageWriter". You must use the 
Chooser desk accessory (it's on the System Tools disk provided by Apple with 
your computer) to select and install the desired printer. 


The Printer Preferences... command under the Customize menu allows 
you to select various options that control how text is printed. This command 
presents you with a dialog box that contains the following options: 


Time/Date Heading 

The option Time/date heading on (every page or first page only) will 
print a title at the top of the selected page or pages telling you when the page 
was printed if it is checkmarked. 


Form Feed At Conclusion Of Printing 

The Do form feed when printing finishes choice will instruct the printer to 
do a form feed at the conclusion of the current printing operation if 
checkmarked. This may or may not be necessary (or desirable) depending on 
what type of printer you are using. If the last page of printing does not seem to 
be ejected from the printer after printing finishes, checkmark this option. 
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Form Feed After X Lines 


The Do form feed after every "x" lines printed option will instruct the 
printer to execute a form feed after every "x" (where x is a number from 1 to 255) 
lines have been printed if checkmarked. This will be necessary when using cut 
sheet paper rather than fanfold paper, especially with laser printers. It's also 
useful with fanfold paper as it prevents printing from taking place on the paper's 
perforation. It also tells the Time/date heading on every page option when 
the next page starts. 


i inti 
The Before sending, send to the printer and After printing, send to 
the printer options allow you to pass special printer commands before and 
after printing text. Because Red Ryder always prints in draft mode using the 
printer's draft mode font, you might use these options to tell the printer to use 
condensed print (if you are receiving 132 characters per line, for instance), or to 
print everything in boldface (if your ribbon is getting weak). The special 
commands to do these kinds of things are listed in your printers user manual. 


You can specify control characters in the strings sent by these options just as 
you do in a Macro Key String, by preceding the character with a caret character. 
To send an ESC (also known as Escape) character, you would type A[ (caret- 
left square bracket). 


The Print TEXT File Comman 

When the Print TEXT File... command is selected from under the Local 
menu, Red Ryder will prompt you for the file to print with a standard file selection 
dialog box, and will then print the file. 


The Echo Incoming Data To Printer mman 

When the Echo Incoming Data To Printer command is selected from under 
the Local menu, it becomes checkmarked in the menu and Red Ryder will echo 
all received characters to the printer after displaying them in the Terminal 
Display Window. To stop echoing the characters to the printer, select the menu 
command again so that it is uncheckmarked. 


This is a good way to get a hardcopy record of an online session. However, if 
your printer is not fast enough to keep up with the incoming characters, it can 
slow down your throughput. When this is true, your session will be no faster 
than your printer, no matter what baud rate you are using. | don't recommend 
using a laser printer with this command, because these printers are made to 
accept a complete document all at once rather than a few characters at a time 
now and then. As an alternative, capture the desired text to a file using the 
Capture Incoming Data To TEXT File... command under the File menu 
(this is discussed in detail in the chapter "Getting It From Here To There And 
From There To Here"), and then choose Print TEXT File... once the capture 
has ended to print out the file. 


Red Ryder Documentation Page 39 


Connecting To Remote Systems 


Red Ryder was designed to not make assumptions about what is connected to 
the serial port, be it a modem, a direct cable connection to another computer, a 
laboratory instrument, or nothing at all. Because the commands to make 
modems dial, answer, or disconnect are varied and brand specific, you will not 
find menu commands in Red Ryder like "Hang Up Modem”. Instead, Red Ryder 
allows you to fit the software to your particular application by using a generic 
Dial Or Rediat A Number... menu choice, and allowing you to construct 
customize routines (using Red Ryder's Procedure Language and Macro Keys, 
which are explained elsewhere in this manual) for other necessary functions. 


The Dial Or Redial A Number... choice found under the Service menu is 
one of the few modem specific commands in Red Ryder. To work properly, it 
must be used in conjunction with a Hayes compatible modem. Although you 
could type a modem dialing command directly on your keyboard (as explained 
in the chapter "Serial Port Settings"), this menu command gives you the added 
versatility of letting Red Ryder continuously redial a phone. number until a 
connection is achieved. 


Before selecting the Dial Or Redial A Number... menu choice, it's usually 
wise to type an "AT" modem command (followed by pressing Return) or two to 
make sure the modem is ready to accept a dialing command (it should respond 
with "OK" if it is). 


Once you have selected the Dial Or Redial A Number... menu command, 
you'll be prompted to enter the modem dialing command. This is typically 
"ATDP" if you have a pulse phone, or "ATDT" if you have a touch-tone phone, 
followed by a single space, followed by the phone number you wish to dial. Ifa 
touch-tone phone is being used, you might enter this: 


ATDT 1 (800) 555-1212 


The spaces, parentheses, and hyphen in the phone number is ignored by most 
Hayes compatible modems. 


After entering the modem dialing command, you would click either on the 
Cancel button if you change your mind and want to get out of this function, the 
Dial button if you wish to dial the number only once, or the Redíal Until 
Connected button if you wish to continuously redial until a connection is 
established. 


Some countries have federal laws concerning how many times a number can 
be repeatedly dialed mechanically. In the United States, it's 15 times. The 
dialog box presented when you select the Dial Or Redial A Number... menu 
choice contains an editable value called the Redial Limit. This number 
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ranges from 0 to 255, and tells Red Ryder the maximum number of times to 
redial a number before giving up. If you.are in a country where redialing Is 
unrestricted, you can enter a zero as this value and Red Ryder will redial forever 
(if you let it). 


Once a redial begins, a new window is presented that displays the current 
status of the redial. To cancel a redial in progress, click inside the close box of 
this window. Once a connection is established or the redial limit is reached, 
Red Ryder will continuously beep at you until you click in the close box. 
Lengthy redials present a perfect opportunity to catch up on reading, or if you 
choose, continue to work inside of desk accessories. 


Be aware that in order for the redial function to work, you must be using a Hayes 
compatible modem, and the modem must conclude a dialing function by 
returning one of the three messages: "CONNECT", "BUSY", or "NO CARRIER". 

It doesn't matter if the "CONNECT" message also returns a baud rate, as in the 
message "CONNECT 1200". For many Hayes compatible modems, the 
following modem command is used to enable the above function: 


ATQ1V1X1 


If your modem returns the message "ERROR" after typing in the above 
command, try the command: 


ATQ1V1 


As with all modem commands, the above should be typed directly on the 
keyboard, followed by pressing the Return key. If all goes well, the modem 
should return an "OK" message to your screen. 


Finally, please be smart about how you use the redial feature. When | used to 
operate a BBS in my home, it had the bad habit of crashing every day or two 
(this was before | wrote Red Ryder Host - it was operated on an IBM-PC I had 
gathering dust in the back room). It was easy to tell when the BBS crashed, 
because some jerk would then decide to start redialing my voice line (just to see 
if there was a BBS connected there, | suppose). Of course, he turned off his 
modem speaker so as not wake anyone in his home at 3 a.m., and therefore 
couldn't hear me screaming "Hullo?" (or much worse). The net effect was that 
my phone would ring twice per minute for several hours on end. One night, | got 
very angry and answered the phone - twice per minute - for over three hours. | 
suspect he got the message when his phone bill arrived the next month - | hope 
he was calling from Boise. The moral of this story is, don't redial a number you 
absolutely aren't positive is connected to a computer. 
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The Call, Edit, and Delete buttons are inactive unti! you select an entry by 
clicking your mouse in it. When selected, an entry is displayed highlighted, as 
in the entry "Fou! Systems, Inc." in the above illustration. 


Unlike the mechanical variety, the pages in Red Ryder's phonebooks are 
endless. When a page contains more than 14 entries, the vertical scroll bar on 
the right edge of the page becomes active so you can scroll through the various 
entries to the desired one. 


To get rid of an entry, select it and then click on the Delete button. 


To add a new entry, click on the Add button. A dialog box will appear asking 
you to supply the following information about the entry: 


«Name: This is the name of the entry, that will appear on the selected page 
when the phonebook door is opened. 


* Dialing command: This is the modem dialing command (explained in detail 
in the chapter "Connecting To Remote Systems") that would be precisely as you 
would type it into the dialog box presented after selecting the Dial Or Redial 
A Number... menu choice. 


Settings file: This is the settings file that you wish to load in before the 
redialing commences. Use the Get Settings File button to easily fill in this 
entry with a proper file name. This item is optional and can be omitted. 


» Procedure file: This is the compiled Procedure File that you wish to execute 
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You can click inside the close box to get rid of a phonebook at any time. The 
phonebook resembles the mechanical desktop equivalent in appearance and 
function. The grey box is the "door" under which contains the entries. The 
name of the phonebook (in this case, | created it as "Little Black Book") is 
centered in the door. The right edge contains a sliding control knob that lets 
you open the phonebook to one of thirteen alphabetically sorted "pages" of 
entries. To open the phonebook to a specific page, simply drag the sliding knob 
with your mouse until it is next to the letters you desire, then click your mouse in 
the Open button. The door will then open in an animated fashion and the page 
displayed. To display a different page, drag the control to a different pair of 
letters. The door will close and the Open button will reappear underneath the 
door. 


When the door is "open", the phonebook looks like this: 
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Getting It From There To Here 
Or From Here To There 


File transfers are used to achieve several objectives: 


» Dumping a text file from your disk over the modem 

* Capturing what comes over the modem to a text file on your disk. 

« Transferring a file (text or otherwise) that resides on a remote machine to your 
machine with error checking and correction to insure that it arrives Safely. 

» Transferring a file (text or otherwise) that resides on your disk to a remote 
machine with error checking and correction to insure that it arrives safely. 


File transfers are usually where beginners get pretty confused and frightened, 
because they are supported with what seems like a bewildering array of 
options. Actually, transferring files is not difficult at all in the vast majority of 
cases, and after a few test runs, you'll be zipping things back and forth like a 
pro. The options are there only for special circumstances, such as with dealing 
with a rather "stupid" communications program on the other end, or for 
transterring files between unlike machines. 


In communications jargon, uploading a file means sending it from your 
machine to a remote. Downloading means receiving a file on your machine 
from a remote. 


We'll look at the first two objectives listed above, which we refer to as text file 
transfers. A text file is defined as being composed only of alphanumeric 
characters. A text file cannot contain non-alphanumeric characters except for 
tabs and carriage returns (we'll discuss this in more detail later). What it boils 
down to is that if you choose Send Text File... and the file you want to send is 
not displayed in the file selection dialog box, it isn't a text file and you'll have to 
use XMODEM or Kermit to send it (and hope the receiver can do something with 
it once they get it). | 
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after the redialing is terminated. Use the Get Procedure File button to easily 
fill in this entry with a proper file name. This item is optional and can be omitted. 


- Notes: This can be anything you want, up to 80 characters of personal notes 
about the entry, account numbers, passwords, etc. If you are going to put 
sensitive information in this section, | strongly advise that you password protect 
the phonebook so that it can not be compromised if stolen or copied. This item 
is optional and can be omitted. 


Once an entry has been added, you can modify the information in it (or view the 
"Notes" data) by clicking in the Edit button. 


After selecting an entry and clicking in the Call button, the following steps take 
place in chronological order: 


1) If the "Settings file" portion of the entry is not empty, the appropriate Settings 
file is loaded in. Ä 


2) The dialing command is passed to the Dial Or Redial A Number function, 
and a redial until connection begins as explained in the chapter "Connecting To 
Remote Systems". 


3) When the redial terminates (with the YES/NO flag set as explained under the 
REDIAL command listing in the chapter "Procedure Language Commands"), if 
the "Procedure file" portion of the entry is not empty, the appropriate Procedure 
file is immediately executed. If it is empty, Red Ryder will beep at you 
continuously until you click in the redial window's close box. 
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Transfer Preferences... choice brings up a dialog with the option Wait after 
each line sent for x character. If this option is checkmarked, after each 
line (terminated with carriage return) is sent, Red Ryder will patiently wait for the 
remote machine to send the character "x" (which you fill in the dialog box with 
your choice) before sending the next line of text from the file. The prompting 
character must be alphanumeric - no control characters are allowed for this. 


Here's an example of when you might use this option. Let's say that you've 
typed an electronic mail message into your word processor and saved it as a 
text file. Now you use Red Ryder to connect and log into your favorite electronic 
mail service, and wish to upload the message. This saves connect time (and 
perhaps long distance charges) because Red Ryder can send the file much 
faster than you can type it while online. For the sake of our example, let's say 
that the electronic mail service's editor works like this: 


1» Dear Bob: 
2» This is a short test message. 
3» 


In this example, the editor prompts me for each line by typing the current line 
number followed by a greater-than symbol (»). Knowing this, | could get into the 
service's editor, wait for it to prompt me for the first line of entry (it would send a 
"1»") and then start sending my file. Of course, | would be clever enough to first 
tell Red Ryder to wait after each line sent for a » character. 


+ Line-by-line or character-by-character pacing. Sometimes when we 
are forced to connect to archaic remote machines, we find that they are unable 
to keep up with the speed which we send them information. The typical result is 
lost characters. Red Ryder is equipped to automatically use a handshaking 
method called XON/XOFF which you'll find most up-to-date equipment will 
deal with in a nice way with no loss of information. If you do discover lost 
characters, however, don't despair. Red Ryder has two other methods for 
slowing things down for the remote. Under the Customize menu, the Text 
File Transfer Preferences... choice brings up a dialog box containing the 
choice Delay after each. When this option is checkmarked, Red Ryder will 
introduce delays at certain points during the transfer, depending on how the rest 
of this option is filled out. | 

You can select Delay after each line sent for x seconds, where "x" is a 
value from 1 to 9 seconds, and Red Ryder will wait that number of seconds after 
each line (terminated with a carriage return) is sent before sending the next line 
of text from the file. Or, you can select Delay after each character sent for 
x 60ths, where "x" is a value from 1 to 60, and Red Ryder will wait that number 
of 60ths of a second after each character is sent before sending the next 
character in the file. 


How do you decide which method (line-by-line or character-by-character) of 


pacing to use? If in the received file (on the other machine) you discover that 
characters are lost only at the beginning of lines, you should pace on a line-by- 
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Sending Text Files 


Under the File menu, the choice Send Text File... is used to send a text file 
from your disk over the modem. This is a "raw" dump of the file to the modem 
which means that the file is sent through the serial port character by character 
without any error checking or correction. Therefore, telephone line interference 
can actually transform characters into garbage, or even delete them. There's no 
way of knowing whether or not the file arrived in the same condition it was sent 
(other than by the observation of the receiver), so critical data should not be 
sent by this method (use XMODEM or Kermit instead) when there is a chance of 
such interference. 


You should also know that this type of transfer does not insure that the receiver 
actually gets the file on their disk. The receiver must instruct their 
communications software to capture the incoming data to a text file before you 
send it, and must close the file immediately after the last characters are sent to 
avoid capturing any additional (and possibly undesirable) characters in the 
received file. 


When Send Text File... is chosen, a standard file selection dialog box will 
appear on your screen. Only files of type TEXT will be shown, to prevent you 
from sending anything other than a text file. Once you've chosen a file, it will be 
opened and immediately sent, character by character. During the send, the 
Send Text File... choice becomes Cancel File Send, which allows you to 
cancel a send in progress. Be aware that your keyboard is not locked out 
during a file send. Any characters you type when the terminal display window is 
frontmost will also be sent. 


During a text file send, you may or may not get any feedback as to the progress 
of the transfer, depending on the Duplex serial port setting. If you are using 
Half, Echo, or Null duplex, the characters will be shown in the terminal display 
window as they are sent. If you are using Full duplex, the characters will not be 
displayed unless the remote machine echoes the received characters back. 


Text File Send Options 
There are four Red Ryder options that control how a text file is sent: 


¢ End-of-line character(s). Under the Customize menu, the Keyboard 
Mapping Preferences... choice brings up a dialog box that contains the 
option Return Key Sends. Ifthe carriage return and linefeed radio 
button is selected, Red Ryder will send a linefeed character after every carriage 
return character it sends from the file. Otherwise, the file will be sent exactly as 
it is on your disk. 


- Line-by-line prompting. Under the Customize menu, the Text File 
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the target machines seems to choke on a file you send it, and you know that the _ 
file is plain text, check first to see that it is formatted to the correct right margin 

column (see Wordwrapping above), and that you are concluding each line 

with the correct end-of-line characters (see End-Of-Line Characters above). 
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line basis. If characters are dropping out at various places in the lines, you 
should use pace character-by-character. To anticipate your next question, | 
really can't be much help on what values to use for the delays. If a system is 
quirky enough to require using this option, only experimentation (and perhaps 
even a reduction in baud rate if possible) will yield the proper values to use. 


* Word-wrapping. Up until now, we really haven't discussed too much what a 
text file is, other than that it’s just a file containing text. The way that each line in 
terminated, however, is very important because some systems must have their 
cake and eat it too, or they'll just refuse to work with you. Most systems you will 
encounter will not allow an unlimited line length. Send them a line of text 
longer than they can handle (usually 80 or 132 characters, but we've seen all 
sorts of bizarre limits), and they'll choke and puke and make life miserable for 
you. Therefore, we sometimes will need to make sure that our lines of text do 
not exceed that limit. Under the Customize menu, the Text File Transfer 
Preferences... choice brings up a dialog box with the option Wordwrap line 
ends in sent files at x columns, where "x" is a value up to 132. If this 
choice is checkmarked, Red Ryder will load each line of text from the file into 
memory before sending it. If the line is longer than the limit, Red Ryder will send 
that line up to the end of the word underneath that limit, a carriage return, and 
then the rest of the line. The result is a nice paragraph reformatted to the 
desired column number without any words broken in the middle. 


Helpfu! Hints For Sending Text Files 


The difference between a text editor and a word processor is that a text editor 
works with nothing but characters, but a word processor is capable of including 
graphics, superscripts, subscripts, and character attributes such as fonts, 
character point sizes, styles, etc. As you might guess, this type of information is 
not what we would call "plain text". In order to use the Send Text File choice, 
we must have a file on our disk in plain text format, but there are some things 
you need to be aware of to accomplish this. 


1) Choosing Save... from your word processor's File menu will probably save 
the file in a binary (non-text) format which only that word processor can 
recognize. If you will be transferring a file to a Macintosh equipped with the 
same word processor (or one that is able to read your word processors 
documents), you should use Send File - XMODEM... rather than Send Text 
File to transfer the file. In order to get a document down to a "plain text" level 
that can be sent with the Send Text File command, most word processors 
give you this option when you choose Save As... from their File menus. 


2) The end-of-line character(s) can be very important for a successful transfer. 
When the Macintosh was created, a design decision was made that makes 
Macintosh text files not very compatible with non-Macintosh machines. Most 
non-Macintosh machines (including IBM-PC's, minicomputers and mainframes) 
we've worked need two special characters to designate that end of a line, a 
carriage return character and a linefeed character. The Macintosh only needs a 
carriage return character, and in fact will deal rather poorly with linefeed 
characters, displaying them as rectangles at the beginning of each line of text. If 
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something similar to "Start your transfer NOW". 


3) You go to the File menu and choose Send File - XMODEM. A standard 
file selection dialog box is displayed, and you pick out the file "FOOBAR". 


4) Meanwhile, your buddy goes up to his File menu and chooses Receive 
File - XMODEM. He is presented with a standard file definition dialog box, 
into which he types the file name "FOOBAR". 


5) Both of you will then see a file transfer status window appear which tells you 
that the transfer is in progress. After a few moments (don't panic unless it takes 
more than 30 seconds or so --your buddy may be a slow typist or get confused 
momentarily along the way), the transfer should begin. Everything is automatic 
from this point on, and you can just sit back and watch until Red Ryder reports 
the conclusion of the transfer. 


In the above example, you could substitute the Send File - Kermit and 
Receive File - Kermit menu commands if you desired to use the Kermit 
protocol rather than XMODEM. 


During the transfer, you'll notice that the file transfer status window can be 
relocated by dragging the mouse cursor in the title bar. You'll also notice that 
the Apple menu is enabled, which means you can open and work with desk 
accessories while the transfer is in progress. This gives you the freedom to get 
something productive done while otherwise you would just be waiting for the 
transfer to finish. However, if Red Ryder is loaded as an application under 
Apple's Switcher program, you must not switch out of Red Ryder during the 
transfer or it will fail. Also, while a transfer is in progress, especially at baud 
rates higher than 300, don't do things (like hold down a menu for more than a 
couple of seconds or save a very large document to disk) that completely tie up 
the Macintosh for an extended period of time. Normal typing takes up very little 
processing time and shouldn't interfere with the transfer. 


Because it's impossible to list everything you can or can't or should or shouldn't 
do during a transfer, we'll leave it up to you to experiment with various desk 
accessories during transfers. The worst that could happen is that the transfer 
will fail, and will have to be restarted. 


Let's take a look at the contents of the file transfer status window during a file 
transfer. 
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Receiving Text Files 


When the Capture Incoming Data To Text File... choice is selected from 
under the File menu, you are presented with a standard file definition dialog 
box. In this box, you type in the name of the file you wish to save information to, 
and specify where to save the file. Once the Save button is clicked, you will 
notice that under the File menu, the Capture Incoming Data To Text 
File... choice has changed into End File Capture. Everything that comes in 
over the modem will be saved to the file until you choose End File Capture or 
quit Red Ryder. 


What this means is that although you are creating and receiving to a file, what 
you are receiving does not actually have to come from a file on the remote 
machine. Since anything and everything received is captured to the disk file, 
you could be recording an entire session (or parts of a session) for later perusal 
and editing. Just like with sending text files, no error checking or correction is 
done. "Garbage" characters caused by phone line interference will be captured 
along with everything else, so this is not a good way to capture information of a 
critical nature. 


lf | wanted to get a disk file containing all of the electronic mail messages that 
have been sent to me, ! could either: 


A) Choose Capture Incoming Data To Text File..., log onto the system, 
read my mail, log off the system, and then choose End File Capture. Or... 


B) Log onto the system, navigate through the system to the menu that allows me 
to read my mail, choose Capture Incoming Data To Text File..., read my 
mail, choose End File Capture, and then log off the system. 


If | use the first method, the entire session will be captured in the disk file, 
including the stuff I really didn't want. The second method is much more 
selective in that I'm only doing the capture while the information I'm really after 
is coming over the modem. 


There are three options that affect how a text file is received: 


. Received Text File Creator. Every Macintosh file is given two signatures 
when it is created, the file type, and the file creator, both of which are four 
alphanumeric characters. For text files, the file type will always be TEXT. The 
file creator tells the Finder what application to start up when you open a 
document on the Desktop. In other words, if you double-click on a MacWrite 
document, the Finder looks at the document, sees that it has the same file 
creator as MacWrite, and therefore knows that it needs to start up MacWrite 
and pass along the name of that document to open. Since there's no way for 
Red Ryder to know what you use as your favorite word processor, it gives you 
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As an aside, the bizarre looking character at the end of “The Venice Project’ 
was probably meant to be a trademark symbol, which has been replaced with a 
VT100 graphics character in the TTY-VT52-VT100 font. 


What ! i 

Macintosh disk files are very different from files on any other current 
microcomputer in at least one regard. Most non-Macintosh computers store all 
file data in one big clump. The Macintosh, however, actually divides each disk 
file up into two subfiles, which are called forks. The data fork is equivalent to 
what non-Macintoshes use to hold the contents of a file. But a Macintosh file 
can contain such things as icons, pictures, dialog boxes, and a whole mess of 
other things that don't have an equivalent on non-Macintosh machines. For this 
reason (and others we don't need to get into), the designers of the Macintosh 
decided to give each disk file a resource fork to hold such things. 


Finally, it is desirable to know other things about a file (called Finder 
information) that should be included in a file transfer. Some of these things 
are pretty esoteric as far as you're concerned, but they do include some things 
like the original file name, the file's creation and last modification dates, which 
icon should be displayed by the Finder for that document, and the file type and 
file creator (these two things were discussed previously in this chapter). 


What this boils down to is that when we send a Macintosh file, we need to 
include three separate entities: the data fork, the resource fork, and the Finder 
information. The authors of all major Macintosh communications software met 
and agreed up a standard for doing this. This standard is called MacBinary, 
and guarantees that a file sent by one Macintosh will arrive in the same 
condition when received by any Macintosh communications program that 
supports this standard. 


The beautiful thing about MacBinary is that it is completely invisible to a non- 
Macintosh, meaning that you could send a Macintosh application or document 
to a non-Macintosh, and then that non-Macintosh could then send the file to a 
second Macintosh. Since the non-Macintosh does not recognize MacBinary, it 
simply stores the file serially on it's disk as it is received. However, the second 
Macintosh recognizes that the file is in the MacBinary format as it receives it, 
and does the conversions necessary to restore the file to its original condition. 


Red Ryder will send any file that does not have a file type of TEXT using the 
MacBinary format. A file with the file type TEXT will only have its data fork sent, 
not its resource fork or Finder information, so that it can be used by text editors 
and word processors on non-Macintosh machines. 


What Is YMODEM? 

YMODENM is nothing more than a repeating XMODEM transfer of a group of 
files. If you've got fifty small files to send, for instance, it is a pain in the neck to 
have to keep sitting behind the machine, picking and sending one file at a time. 
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Sending And Receiving Files 


Using Error Correcting 
Protocols 





Performing file transfers in a "raw" sense of just dumping characters to the serial 
port or capturing whatever comes over the serial port is at best risky. Because 
of telephone line interference, characters can be changed or deleted, and 
"garbage" characters can be introduced. For this reason, XMODEM and Kermit 
were created to insure that data arrives in the same condition it was sent. 
XMODEM and Kermit are similar in that they are both error checking and 
correcting protocols. A protocol is simply a collection of rules for breaking a 
file up into blocks of data, sending each block, and doing comparisons on the 
block at both ends. The sending portion of the protocol will continue to 
retransmit a block until both sides agree that it arrived safely. Both Kermit and 
XMODEM offer a high degree of reliability (over 99%) and should be used 
whenever the data is important, or when the file is non-textual in content. 


Don't be misled into thinking that XMODEM and Kermit are the same or 
interchangeable. Although they will appear to you to operate similarly during a 
transfer, they consist of very different transfer methods. Kermit was developed 
by Columbia University, and is used most often for transfers with mini and 
mainframe machines. XMODEM was created by Ward Christenson, and is used 
mainly for microcomputer to microcomputer transfers. If you are given a choice, 
use XMODEM because it has a better throughput. 


If you're not given a choice, you'll have to go with whatever the remote machine 
offers. In other words, you can't use XMODEM unless the other machine 
specifically gives you that option. Using unalike or unavailable protocols wili 
result in you seeing a transfer that never begins. 


Performing the actual transfer is very easy, so don't become intimidated. Let's 
take an example of you sending a file called "FOOBAR" to your friend using 
XMODEM. Let's assume that you have both connected and are ready to start 
the transfer. 


1) You type to your buddy, "I'm going to send you the file FOOBAR. Are you 
ready?" 


2) Your buddy types back, "Yes, send away!" It's important to wait until the 
remote machine tells you to begin. If you are sending (or receiving for that 
matter) to an online service, you must wait until it explicitly tells you to begin. 11 
you start too early, you could get hung up on the first block, and the transfer will 
never get started. Remember, wait until the remote machine teils you 
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choosing Set Auto-Receive Volume... will not have any effect on file 
transfers unless the Auto-receive using volume/path choice is 
checkmarked under XMODEM and Kermit Preferences. 


The auto-receive feature does several things: 

* When you choose Receive File - XMODEM, Receive File - Kermit, or 
Receive Batch - YMODEM, you will not be prompted for a filename or where 
to save the file. Instead the file transfer will begin immediately. 


» If the file is in MacBinary format, the file's original name will be used, unless a 
file by that name already exists on the disk. If this happens, you will by notified. 
and asked to supply a different file name at the conclusion of the transfer. 


. If the file is not in MacBinary format, you will be notified and asked to supply a 
file name for the file at the conclusion of the transfer. 


- If during the session a special auto-receive begin sequence is received, 
the appropriate kind of file transfer will begin without you having to select a file 
transfer choice from the File menu. This is a special sequence of control 
characters that several (but not all) Macintosh communications programs 
recognize, and it allows the sender to "drive" your machine during a session. 
Red Ryder will send this sequence before starting any file transfer if the choice 
Before sending, instruct remote Red Ryder to auto-receive is 
checkmarked in the XMODEM and Kermit Preferences... dialog box. 


It is possible (although rare) for line noise generated "garbage" characters, or 
"trojan horse" messages on BBS systems (which are in this case harmless, but 
annoying) to be interpreted as an auto-receive begin sequence. If you find Red 
Ryder going into a file receive mode at odd times, simply turn off the auto- 
receive feature and these sequences will be ignored. 


XMODEM And Kermit Preferences 
Under the Customize menu, the XMODEM And Kermit Preferences 


choice presents you with a number of options. For each of these options, you 
should consider XMODEM options to also affect YMODEM transfers in a similar 
manner. 


. Timeout. The option Timeout after x seconds controls how long Red 
Ryder will wait during an XMODEM transfer for a response from the remote 
machine before either resending a block of data or requesting a resend. The 
value you type in for "x" (between 1 and 255 seconds) controls the longest 
amount of time Red Ryder will wait. The normal value for timeouts, 5 seconds, 
may need to be extended for some mainirame services like CompuServe, since 
unexpected delays may occur during the transfer. | would suggest a value of 
10-20 seconds for such services, if you observe that the line quality is clean, but 
are still seeing an abnormally high number of timeout errors during a file 
transfer. When transferring to another microcomputer, | strongly suggest you 
reset this value back to 5 seconds. 
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Receiving File Using HMODEM Protocol 
(BINARY )/XMODEM Received block #129... verified. Estimated time left: 
Total received: 16384 of 81536 bytes. Errors: 0 

10% 203 308 40% 504 60% 70% 80% 90% 


10:38 


Filename: ‘venice.bin’ 
Hill attempt to rename as: 'The Uenice ProjectK' 


Let's discuss the contents of this window from top to bottom, left to right. The 
title bar tells us the kind of file transfer being done. The leftmost part of the top 
line of the status display tells us about the transter, in this case, we are receiving 
a MacBinary formatted file (The "(BINARY) message tells us that - a (TEXT) 
message would be displayed if the file was not in MacBinary format). An 
asterisk would be displayed just before this message if the SUPE RCHARGED 
XMODEM™ option were turned on. After the protocol being used (XMODEM in 
this case), the current block number is displayed. After a block is received, the 
error checking will be done and either "verified" or "transmission error" will be 
displayed. Finally on this line, an estimation for the time remaining in minutes 
and seconds is displayed. Don't be surprised if the seconds portion jumps 
erratically during the early stages of the transfer - it will get more accurate and 
steady as the transfer progresses because mechanical and response delays 
get averaged out. 


The second line of the status display tells us how many bytes have been 
transferred, and if you are sending a file or receiving a MacBinary format file, the 
total number of bytes to be transferred are also displayed. Finally, the number 
of consecutive errors for the current block is displayed. Notice that this is the 
number of consecutive errors, not cumulative. When an error is corrected, the 
error count is reset to zero. 


If a file is being sent or a MacBinary format is being received, a graphic display 
of the transfer is shown in the middle of the window. In the above display, we 
can see that roughly 20% of the transfer is complete. In case you're wondering, 
this display is intentionally oversized, because | personally like to go to the 
other side of my room and watch television while a long transfer is running, yet 
still be able to keep my eye on its progress. Longhairs call this ergonomic 
engineering. Just think, last week | couldn't spell engineer, now | are one. 


At the bottom of the window is the file name you typed when starting the transfer 
(or "Unknown" if the auto-receive option is turned on and you are receiving a 
file). If you are receiving a MacBinary format file, the original file name (which 
Red Ryder will try to rename the file to after it's received if a file by that name 
doesn't already exist) is also listed. 
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checkmark this option only when you will be sending the TEXT file to a 
Macintosh with a MacBinary recognizing communications program. A non- 
Macintosh machine will not be able to make sense of a MacBinary formatted file 
once it has received it . 


» Text file creator. The Received non-MacBinary format TEXT file 
creator option is equivalent to the Received Text File Creator option under 
Text File Transfer Preferences described earlier in this chapter. The 
selected file creator will be given to non-MacBinary TEXT files received using 
XMODEM or Kermit. | 


- Stripping linefeeds. If the Strip linefeeds from received non- 
MacBinary format TEXT files option is selected, Red Ryder will strip out any 
linefeed characters in a non-MacBinary formatted text file when receiving the 
file XMODEM or Kermit. Unlike the Text File Transfer Preferences option 
Strip control characters from received files, this option only strips out 
linefeed characters, and not any other non-alphanumeric characters. 


. Auto-receive. This option is discussed in detail earlier in this chapter under 
"The Auto-Receive Feature". 


| Instructing remote to auto-receive. This option is discussed in detail 
earlier in this chapter under "The Auto-Receive Feature". 


- CompuServe 'B' Protocol Recognition. Besides XMODEM, YMODEM, 
and Kermit, Red Ryder can receive (but not send) files using a fourth error 
checking and correcting protocol called the CompuServe 'B' Protocol. This 
protocol is to be used only with the CompuServe timesharing network. 


You'll notice that there is no "Receive File - CompuServe 'B' Protocol" choice 
under the File menu. This is because this protocol is initiated in a different 
manner. When you tell CompuServe to use the 'B' protocol to send you a file, it 
will prompt for the file name on your machine. What it is asking you is to supply 
the complete pathname to save the file as on your disk. Don't forget to supply 
the volume (and HFS folders) name as part of the file name as described in the 
"What's In A Filename?" chapter. Once this file name is supplied, CompuServe 
will send a special sequence that Red Ryder will recognize when this option is 
checkmarked, and the transfer will begin automatically and will appear similar 
in operation to an XMODEM or Kermit file transfer. 


Since XMODEM may not be very reliable on CompuServe during peak traffic 
hours, we do recommend that you use 'B' protocol with that network during busy 
periods (when there are noticeable delays in network response). 


« SUPERCHARGED XMODEM™. When the SUPERCHARGED 
XMODEM" receive choice is checkmarked, Red Ryder will use a special 
method of responding to the sender that has the effect of speeding up a file 
transfer with certain networks drastically. This method entails short circuiting 
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Red Ryder allows you to create a batch of files to send and will then send that 
batch of files one at a time automatically without further intervention from you 
necessary. A batch is nothing more than a file containing a list of file names to 
send. 


To create a batch, choose Create YMODEM Batch... from under the File 
menu. First, you will be prompted for the name of the batch file you wish to 
create. This file name will be later selected when you choose the Send Batch 
. YMODEM command. You will then be presented with a standard file 
selection dialog box. Navigate to the file you want to include in the batch and 
select it. The file selection dialog box will disappear briefly as it adds the file to 
the batch. The file selection dialog box will then reappear to let you know that it 
is ready for the next file you wish to add to the batch. Once you've selected all 
of the files you desire, click on the Cancel button to close the batch file. 


To send the batch of files, choose Send Batch - YMODEM from under the 
File menu. The receiver should choose Receive Batch - YMODEM from 
under their File menu. At this point, the first file transfer will begin, with each file 
inthe batch sent in order as the prior file transfer concludes. The receiver iS 
only prompted as to which disk (or HFS directory) the batch of files is to be 
saved in before the transfer begins. 


One important note: if you choose Send Batch - YMODEM, the receiver must 
choose Receive Batch - YMODEM, and not Receive File - XMODEM. 
Although XMODEM and YMODEM are closely related in function, they are not 
interchangeable! 


The Auto-Receive Feature 

One of the things included in a MacBinary transfer is the file's original name. 
Many people have expressed surprise that they have to type in a file name 
before a MacBinary format file is received, only to have the file name they type 
replaced by the original file name. Wouldn't be easier, they asked, if | just 
chose Receive File - XMODEM and the transfer would begin without further 
delay, using the file's original name? 1 relented, and the auto-receive feature 
was born. 


Under the Customize menu, the XMODEM And Kermit Preferences... 
choice brings up a dialog box that contains the choice Auto-receive using 
volume/path. When this choice is checkmarked, the auto-receive feature is 
enabled. Under this choice is the volume (or HFS directory) where files 
received using XMODEM, YMODEM, or Kermit will be saved if this choice is 
checkmarked. 


Because Red Ryder can not know what disks you'll choose to have mounted 
when it is run, it always starts out each session with the auto-receive 
volume/path set to the same volume (or HFS directory) that contains Red Ryder. 
This volume/path can be changed by choosing Set Auto-Receive Volume... 
from under the File menu. The selected volume/path will remain in effect for 
the remainder of that session (or until it is changed during that session). Just 
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Getting Rid Of Files 


Now and then when you need to clean up or make more space, you'll wish to 
get rid of disk files while running an application. When this happens, you've got 
one of two choices: | 


+ Quit Red Ryder and return to the Finder. This is time consuming and the least 
desirable method. 


* Use one of the public domain desk accessories that have a file deletion 
command. While better than quitting Red Ryder, this does take up a valuabie 
desk accessory slot under the Apple menu, and for that reason may not be 
desirable. 


For this reason, we've included the Delete A File... choice under the File 
menu. After you choose this, a standard file selection dialog box will appear 
allowing you to select the file to delete. When you click on the Select button, 
Red Ryder will not delete the file immediately, but will first bring up a second 
dialog box to allow you to confirm that the file should be deleted, or give you 
one last chance to change your mind. 


Red Ryder Documentation Page 62 


* Special Kermit ^Q handshake. This option, when checkmarked, tells 
Kermit to use a special kind of signalling at the end of each transferred block. 
This handshaking is necessary only for certain IBM mainframes, and should not 
be checkmarked unless the system operator of the remote machine explicitly 
tells you that "Control-Q handshaking" is necessary. If itis selected and the 
remote machine does not need it, the transfer will not work properly and will 
ultimately fail. 


e CRC Error Checking. When XMODEM was originally introduced, it utilized 
a simple form of error checking called checksum. Later, a more reliable method 
called CRC was introduced. When the option Use and recognize CRC 
error checking is checkmarked, Red Ryder will first attempt to use CRC error 
checking when sending a file XMODEM. If the remote machine does not 
understand how to do CRC error checking, Red Ryder will automatically switch 
to checksum error checking. To save some time at the beginning of the transfer, 
you should not checkmark this option if you are absolutely certain that the 
remote machine does not know how to do CRC error checking. Otherwise, let 
Red Ryder make the decision by leaving this option checkmarked. When 
receiving a file XMODEM when this option is checkmarked, Red Ryder will 
automatically adapt to whatever method of error checking the sender is using. If 
this option is not checkmarked, Red Hyder will force the sender to use the 
checksum method of error checking. 


e MacBinary format. When the option Use and recognize MacBinary 
format for non-TEXT files is checkmarked, Red Ryder will use the 
MacBinary format (explained earlier in this chapter) for sending all files using 
XMODEM or Kermit that have a file type other than TEXT. If this option is not 
checkmarked, Red Ryder will only allow you to send files with a file type of 
TEXT, and will send only the data fork of the file. When receiving a file, if this 
option is checkmarked Hed Ryder will recognize a file in the MacBinary format, 
and will convert it to its original form at the conclusion of the transfer. If it is not 
checkmarked, it will save all blocks of data in the data fork of the received file, 
give it a file type of TEXT, and do no conversion at the conclusion of the transfer. 


The only time this option should not be checkmarked is when you will be 
receiving a non-TEXT file from a non-Macintosh machine. Certain non- 
Macintosh files (such as Lotus 1-2-3 .WKS files) have data at the beginning of a 
file that may fool Red Ryder into thinking that the file is a Macintosh file in the 
MacBinary format. 


e Sending TEXT files using MacBinary. If the Send TEXT files using 
MacBinary format option is checkmarked, files with the file type TEXT will be 
sent using the MacBinary format. This is useful in certain circumstances, such 
as when the Finder information (such as the original file name, creation date, 
etc.) is important. Some text editors and word processors also store some 
information in the resource fork of a TEXT file, such as tab stop positions or the 
font and point size to use when the document is opened. This information is 
only sent when the file is transferred in the MacBinary format. You should 
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will skip the scrolling and just display the new set immediately. 


- Display title screen at program startup: OK, so now you know the 
name of the program and who wrote it and all that good stuff. This option, when 
checkmarked, will skip the pretty intro and get right to the guts of what you're 
trying to do. 


* Cancel procedure in progress when new procedure is executed: 
Normally, when a new procedure is executed by a Macro Key when another 
procedure is running, an error message is displayed telling the user to cancel 
the procedure in progress before running the new procedure. Ifthis option is 
checkmarked, the procedure in progress will be automatically cancelled, and 
the new procedure will be executed with no such message given. 


+ "Strip control characters" allows tabs to pass through: Normally, the 
Strip control characters option in the dialog box presented by the TEXT 
File Transfer Preferences choice under the Customize menu will strip out 
tab characters along with all other control characters besides carriage returns. 
If this option is checkmarked, tab characters will be allowed to pass through to 
the file (will not be stripped out) when using the Capture Incoming Data To 
TEXT File command. 


. Confirm choice before: For the functions listed below, Red Ryder normally 
presents you with a confirming dialog that verifies that you really want to do that. 
Once you gain a little confidence, you may wish to turn off this confirming dialog 
for any or all of these functions: 

1) Deleting a file. 

2) The Send Screen To Printer button in the General Status Bar. 

3) The Send Screen To Disk button in the General Status Bar. 

4) The Close Box in the Terminal Display Window. 

5) The Reset Time And Billing Clocks buttons in the General and 

Macros Status Bars. 


- Buffered keyboard right margin column: Some services will allow 
many lines of characters to be sent all at once. Others allow only a single line 
orless. This option allows you to specify the maximum number of characters 
the Buffered Keyboard will hold before the Return key must be pressed. It 
can be a number as large as 32,000. 


Red Ryder Documentation Page 64 


the error correcting mechanism, so if an error is detected, the file transfer will be 
cancelled by Red Ryder. Therefore, it should be used only when you are 
certain of excellent telephone line quality. This feature only yields beneficial 
results with certain timesharing networks, of which CompuServe and Delphi are 
two. With other networks, like GEnie or microcomputer based bulletin board 
systems, this option will not make the transfer go any faster, and you lose the 
benefit of error-correction. Therefore, we recommend that this option only be 
used with CompuServe and Delphi, and then only for short files (to reduce the 
risk of a rare error cropping after 99% of a long file has been received) when the 
telephone line quality is excellent. 


.1K blocks. XMODEM transfers normally transmit 128 bytes of data in every 
block sent. When the Use and recognize 1K blocks option is selected, Red 
Ryder will attempt to send 1024 bytes per block. If the remote machine doesn't 
support this feature, Red Ryder will drop back to 128 bytes per block. If it is not 
checkmarked, Red Ryder will only use 128 byte blocks when sending. When 
receiving a file using XMODEM, if this option is checkmarked Red Ryder will 
adapt to whichever size blocks the sender transmits (including mixed size 
blocks). If it is not checkmarked, Red Ryder will force the sender to use 128 byte 
blocks. 


Why use 1024 byte blocks? It reduces the amount of overhead sent with every 
block of data, resulting in faster throughput, especially at baud rates greater 
than 1200. The down side is that if the line quality is not excellant, there is more 
data that must be retransmitted after every error is detected, which may negate 
or even overwhelm the benefits of larger blocks. 


Special Notes About Kermit 
When transferring a non-MacBinary formatted file with the file type TEXT using 


the Kermit protocol, Red Ryder will add linefeeds after carriage returns (as all 
other Kermit programs should) to comply with the Kermit protocol standard. 
Therefore, if you intend to use a TEXT file with a Macintosh text editor or word 
processor that will be downloaded with Kermit, we recommend that you select 
the Strip linefeeds from received non-MacBinary format TEXT files 
so that these linefeeds will be removed during the transfer. 


When requesting a file transfer from a remote machine using Kermit, do not use 
the remote Kermit's "Server Mode". Red Ryder does not support the Kermit 
server mode, primarily because there are other ways to accomplish anything 
the server mode can do. Don't use the server mode commands "GET" or "PUT", 
but instead use the interactive mode commands "SEND" and "RECEIVE" for 
transferring files. 


Special Note About YMODEM 

A YMODEM transfer will automatically turn on the Use and recognize CRC 
error checking option under the XMODEM and Kermit Preferences 
menu choice if it is not already selected. 
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Host Mode 


When you select the Host Mode choice under the Local menu, your 
Macintosh becomes a host system that is capable of sending and receiving files 
upon command by remote callers. All menus are locked out while the Host 
Mode is active. To return to normal operation, click your mouse button. Red 
Ryder will graphically invert the Status Bar area (by displaying it as white upon 
black) when it realizes you've pressed your mouse button. While you are in 
Host Mode, a message telling you so is displayed in the Status Bar area of the 
Terminal Display Window. 


Before entering the Host Mode, you may wish to change the Duplex parameter 
on the General Status Bar to ECHO. This causes Red Ryder to echo back all 
characters received from the remote caller so that they appear properly on the 
caller's screen if they are using FULL duplex. If your remote caller complains 
that the lines echoed back from Red Ryder write over the top of each other, you 
should select the Return key sends carriage return and linefeed option 
in the dialog box presented by selecting Keyboard Mapping Preferences 
from under the Local menu before entering Host Mode. It doesn't really hurt to 
go ahead and turn on the Return key sends carriage return and 
linefeed choice before your remote callers complain - the worst that can 
happen if it's turned on is that they will get double-spaced text. 


Host Mode does not answer the phone when it rings, your modem must be an 
auto-answer type and be configured properly to do this. Nor does Red Ryder 
have a Host Mode command to disconnect the phone when the caller is 
finished. This must be done manually by the remote caller. While your modem 
is busy waiting for calls and connecting, Host Mode is simply waiting for certain 
commands to come across the serial port. Anything but these commands is 
ignored (no error messages are given). This makes Host Mode a "low profile" 
host that is difficult for phone vandals to mess with. With the addition of a 
password protection routine, as discussed in the Procedure Examples chapter, 
Host Mode is impervious to illegal entry. 


Let's say you've left Red Ryder in Host Mode and have left for work, where they 
still use IBM-PC's (ummm....perhaps you work for IBM). You call home and 
connect to your Macintosh's modem. The first thing to do is type 3 or 4 carriage 
returns to clear the command line Red Ryder is scanning. 


Now you're ready to enter a command, or disconnect the call when you're 
finished. After any command you enter is completed, type in a carriage return or 
two before entering the next command. It's also necessary to type a carriage 
return at the end of each command, and you can backspace to correct errors in 


typing. 
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Getting Personal 


You now recognize that Red Ryder is filled to the gills with feature after feature, 
option after option. The very thing that may have seemed so overwhelming to 
you at first glance now represents more power than is available in any other 
telecommunications program on Earth. 


Red Ryder is by no means a static program. It continues to grow and evolve 
based on the needs and suggestions of its users. Unlike many other software 
developers, | not only need, but actively solicit my customers to tell me what's 
right, what's wrong, what's missing, and what can be improved in my work. 


Under the Customize menu, the Personal Preferences choice brings up a 
dialog box that contains several niceties that have been suggested to me. The 
following options are contained in this dialog box: 


- Don't zap high bits (allow international characters): This option 
opens up a whole can of worms. Don't checkmark it until you have read the 
chapter "Using International Or Special Character Sets". Yes, | know that this 
option appears disabled in the dialog box. That chapter will tell you how to 
make it enabled. 


« Screen saving and printing functions ignore blank lines: Functions 
like Archive All Screens will automatically skip over all blank lines until it 
finds the first non-blank line. This option, when checkmarked, however, will 
ignore all blank lines within a block of text being saved or printed. It has no 
effect on either the Capture Incoming Data To TEXT File or Echo 
Incoming Data To Printer menu choices. 


. "Delete A File" continuously cycles until "Cancel" is pressed: 
Normally, the Delete A File choice under the File menu will allow you to 
delete only one file for each time it is chosen from the menu. When this option 
is checkmarked, the Delete A File function will continously cycle between 
selection and deletion of files until you click in the Cancel button in the file 
selection dialog box. It's handy in this manner if you typically delete a bunch of 
files at a time rather than just one at a time. 


» "Find Text" uses zooming rectangle when window shifts: Normally, 
the Find Text choice under the Edit menu will use a graphically zooming 
rectangle to help you find the found text whenever the window shifts. If this 
option is checkmarked, the zooming rectangle is not used, and the found text is 
just graphically inverted (in a flashing manner) a few times. 


« Macros Status Bar scrolls when changing sets: If you find the 


scrolling slow or distracting when changing between macro key sets using the 
up and down arrows in the Macros Status Bar, this option, when checkmarked, 
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The SENDA command does not warn you that it is about to send the file, it 
immediately does so upon receipt of that command. The SENDX and 
SENDK commands both send out “Ready to send..." messages so you know 
the command was accepted and you can begin the transfer. 


The RECA, RECX, and RECK commands all send out a "Ready to receive..." 
message when the command has been accepted and Host Mode is ready for 
you to begin. The *CLOSE* command sends a "Closed..." message when the 
file has been closed and the RECA ended. 


Do not use the RECA command to send files to Red Ryder that contain a Host 
Mode command. All kinds of strange things can happen. Instead, use either 
Kermit or XMODEM to send these files to Red Ryder in Host Mode. 


The Host Mode has a special feature that allows you to use it as a electronic 
mail center. If a RECA, RECX, or RECK command is specified with a 
filename that already exists, the new file received is appended to the end of 
the old file. This is so that Host Mode can be used as a message center, and 
new messages won't overwrite old ones as they are uploaded. For this reason, 
write-protect any disks that contain files you don't want destroyed intentionally 
or by accident. 


Here's an example: Bill Smith calls in and commands Host Mode to RECA 
MAIL:SCOTT WATSON. Host Mode responds "Ready to receive..." and Bill 
types in his message to me. When he's finished, he types in *CLOSE* on a 
new line and Host Mode responds "Closed..." He logs off and Ed Jones calls in 
next. Ed follows the exact same procedure. When I call in fater, i command 
Host Mode to SENDA MAIL:SCOTT WATSON and my messages are sent 
one after another. When I get back to my machine, | delete the file SCOTT 
WATSON on the volume MAIL since I've already read the messages and 
don't need to keep them around. 


For security reasons, there is not a Host Mode command to list the files 
available for sending, but you can type in a short file listing those you want 
remote callers to know about. Just name it something simple like FileList, put 
it on the same disk as Red Ryder, and tell your callers to type the command 
SENDA FileList after they log on. 


You may wish to use ECHO duplex in the Host Mode. This echos back every 
character Red Ryder receives so that it is displayed on the callers screen 
properly if they call using FULL duplex. You must make sure your modem is set 
up so as not to echo back any characters it receives in command mode (for 
Hayes compatible modems, the command ATEO - that's a zero on the end - 
should accomplish this) before entering Host Mode or Red Ryder can get into a 
fight to the death echoing characters back to the modem (which it in turn echos 
back to Red Ryder, which Red Ryder in turn...you get the point). If you find 
yourself in one of these bizarre loops, just select Change Serial Port 
Settings... from under the Local menu and switch to FULL duplex. 
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Settings Files 


Red Ryder's strength is in its flexibility. There are close to a zillion choices in all 
of the various menu commands and dialog boxes that allow you to customize 
Red Ryder to your specification. A setting is what we call anything in Red 
Ryder that you can change. Needless to say, if you use more than one service 
you're going to find yourself spending a lot of time adjusting these settings. Red 
Ryder has a better way. 


When you start up Red Ryder, it looks for a file called "Red's 10.0 Stuff" (or 
whatever version number you're using) on the same disk (and in the same 
folder under HFS) as Red Ryder. 1f it doesn't find a file by that name, it creates a 
new one and uses default settings, otherwise it uses the settings in that file. 
When you quit Red Ryder, it saves the current settings in the "Red's 10.0 Stuff" 
file so that when you run Red Ryder the next time, you come up with the same 
settings you had when you last used it. 


You can, however, create other Settings Files, save them on disk, and load 
them back into Red Ryder at any time. To create a new Settings File containing 
the current settings, select the Save Settings To Disk... choice under the 
Customize menu. To load in a previously saved Settings File, select the 
Load Settings From Disk... choice under the Customize menu. 
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Using International Or Special 
Character Sets 


When using 8 Data Bits and No Parity, Red Ryder normally strips off the Parity 
bit, which makes only 128 of the possible 256 characters in a font displayable. 
This is fine for most purposes, because the standards provided by ASCII 
(American Standard Code for Information Interchange) govern only the first 128 
characters. For users who wish to use international, diacritical, or special 
characters (those typed in conjunction with the Option or Shift-Option keys), like 
'ee' or 'ö', this "high-bit stripping" may not be desirable, and can be turned off by 
checkmarking the Don't zap high bits option in the dialog box presented by 
the Personal Preferences choice under the Customize menu. Please 
realize that because the high 128 characters have not been formally defined in 
a standard, what you think you are sending may not be what the receiver sees 
(or the reverse) unless both of you are using the same font, so be sure to agree 
with the remote machine on which font you'll be using to exchange these 
special characters. 


If you intend to send these special characters, don't forget to set the Control 
characters are sent with option in the dialog box presented by the 
Keyboard Mapping Preferences choice under the Customize menu to the 
cloverleaf key so that the Option key can be used to type those characters. 


WARNING! WARNING! WARNING! This option should not be 
checkmarked without forethought or you may find yourself suddenly 
unable to communicate with some services. CompuServe, for instance, 
requires that the high bit be stripped, and if it isn't, what you'll receive will look 
like garbage. It is because of the potentially hazardous side effect (and the 
tendency for some users (like me) to checkmark things before reading the 
documentation about them), that the Don't zap high bits option in the 
Personal Preferences dialog box is normally disabled and therefore 
unavailable to the casual user. 


Last warning - did you read the last paragraph carefully? To get the 
Don't zap high bits option enabled so that you can checkmark it, you must 
hold down the Option key while selecting Personal Preferences from under 
the Customize menu. 


As explained at the end of the chapter "Terminal Emulation Specifics", Red 

Ryder can use any font installed in your Macintosh in any point size when using 
TTY emulation. However, if you need to use international; diacritical, or special 
characters (those typed in conjunction with the Option or Shift-Option keys) with 
VT52 or VT100 emulation, some minor surgery needs to be done on Red Ryder. 
It will not require rubber gloves, just a simple short Procedure File. Therefore, if 
you're not familiar how to create, compile, and execute a Procedure File, please 
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Host Mode does not match communications parameters with the 
caller. If your parameters are set to 1200-N-8-1 before entering 
Host Mode, the remote caller's parameters must be set exactly the 
same or no commands will be recognized. 


Most of the below commands have an additional component called filename. 
The correct format for this arguement is: 


volume name:file name 


The colon (":") separates the volume name and file name. In other words if a 
host mode command was in the format: 


MELTDOWN filename 


and you wanted to "MELTDOWN" (whatever that means - we're using it as an 
example) a file named "REACTOR" on a disk volume named "NUCLEAR", you 
would type in: 


MELTDOWN NUCLEAR:REACTOR 


You don't need the volume name portion if the file is on the same disk as Red 
Ryder, but | highly recommend you use it to avoid problems. The commands 
used by Host Mode are fairly simple and straightforward: 


SENDA filename - causes Red Ryder to send to the remote caller filename 
as it would if you chose Send TEXT File from under the File menu. 


SENDX filename - causes Red Ryder to send to the remote caller filename 
using XMODEM protocol. 


SENDK filename - causes Red Ryder to send to the remote caller filename 
using Kermit protocol. 


RECA filename - causes Red Ryder to receive from the remote caller 
filename using ASCII protocol. 


RECX filename - causes Red Ryder to receive from the remote caller 
filename using XMODEM protocol. 


RECK filename - causes Red Ryder to receive from the remote caller 
filename using Kermit protocol. 


*CLOSE* - manually stops a file receive started with RECA. Note that the 
asterisks at the start and end of *CLOSE* are required! 


DO filename - exits the Host Mode and immediately executes the Procedure 


File filename. Note that you can get back into Host Mode by using the 
Procedure command HOST. 
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Procedure Files 


A Procedure file is simply a set of written instructions you want Red Ryder to 
perform. Sound like a computer program? It is exactly that, and Red Ryder is 
equipped with a powerful, yet easy to learn and use, computer language of its 
own with over a hundred different commands. Red Ryder's Procedure 

language was originally intended to be used for automatic dialing and log on for 
remote services. It quickly became evident that the possibilities are literally 
endless, and the Procedure language has grown in quantum leaps and 
bounds. 


Earlier versions of Red Ryder's Procedure language, as well as all other current 
telecommunications programs on the market use what computer hackers refer 
to as an interpreter to execute the instructions. This version of Red Ryder sports 
the next technical leap up: a true two-pass compiler. By compiling the written 
commands (called "source code") into a very efficient compiled form (called 
"object code"), Red Ryder offers the following advantages over interpreted 
commands: 


* Extremely fast execution speed, as the translation of the commands to 
something meaningful to Red Ryder has already been done by the compiler 
and need not be done redundantly each time the commands are executed. 


* Source code privacy. The source code commands are translated to a non- 
human readable format. In addition, a very devious method of encryption may 
be performed on the object code at compile time to prevent prying eyes from 
hacking the object code to find passwords or other critical text strings. With a 
few lines of code to add password protection (as shown in Example #12 in the 
chapter "Procedure File Examples"), you can insure that a compiled Procedure 
File will be absolutely useless to unauthorized persons. 


Red Ryders Procedure Language is something many beginners get intimidated 
by because of its obvious power and depth, and put off learning to a later date. 
Please don't confuse this power with complexity. A Procedure file can be as 
simple as a two-liner that sets the communications parameters and dials a 
phone number, or a wild bugger that automates an entire session while you 
sleep. It's up to you how complex you want to get. Start simple, experiment, 
learn, and have fun! With the examples provided, there's no reason you cant 
be programming like a pro after just a few hours of leisurely study. 


Just like learning any other computer language, the best way to learn 
Procedure commands is to browse over the following command descriptions 
(not trying to memorize them), and then look at some examples, referring back 
to the command descriptions for a more complete understanding. Learn a few 
commands at a time, biting off more as you feel comfortable. The examples 
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As an epilog to this chapter, let me explain that Red Ryder's Host Mode feature 
is rather "dumb" when it comes to such systems, as its meant to serve only you, 
rather than a group of people (especially inexperienced users). The FreeSoft 
Company produces a stand-alone product nearly as large as Red Ryder called 
Red Ryder Host that provides for such things as: 


« Telephone answering and disconnecting with automatic baud rate switching. 
« Password protection and multi-level security clearances. 

* Multiple file transfer libraries with fully commented directories. 

¢ Private and multiple category public mail sections. 

+ A built-in Survey Language for polling users or taking orders for products. 

* An easy to use interface that is suitable for first time and inexperienced callers. 


among many other features. This is not so much a plug as a warning to not use 


Host Mode's limited capabilities and bare-bones interface for a job more suited 
to a dedicated application like Red Ryder Host. 


Red Ryder Documentation Page 69 


Creating A Procedure File 


The first step in creating a Procedure File is to type in the list of Procedure 
commands to execute into a text file. That file is then compiled into object code, 
and the object code may be executed. A few words about the source code file. 
A Procedure source code file is created with your favorite 
editor/word processor. Each line must be 79 characters long or 
less, and each line must end with a carriage return. The gymnastics 
involved in coercing some Macintosh word processing applications to do this 
can be frightening. 


If you use MacWrite, make sure you end each line with a carriage return (don't 
let what you type "wrap around" to the next line, but physically press the Return 
key at the end of each line). Choose Save As... under MacWrite's File menu, 
and click in the radio button marked Text only in the file naming dialog box. 
MacWrite will then ask you if carriage returns should signify line breaks or 
paragraphs. You should click in the button labeled Line Breaks. 


Many of us have found out the hard way that most Macintosh word processors 
are designed to work well with fancy formatted documents with multiple fonts, 
pictures, etc., but not plain old text files. For this reason, we have included on 
your Red Ryder master disk an evaluation copy of a desk accessory text editor 
called "RedWriter". 1 strongly suggest that you use a desk accessory text editor 
for creating Procedure source code files. It's always there under the Apple 
menu, and its beautifully suited for the many minor editing jobs that crop up 
while using Red Ryder. 


Once you've created and saved your Procedure source code file, it's time to 
compile it into executable object code. To do this, select Compile TEXT File 
To Procedure... from under the Service menu. You will be prompted to 
select the text file to compile, and then for the name of the resulting Procedure 
File. Don't worry about the compile doing anything to your source code file - it 
only reads it and does not change it in any way. A special window will appear 
during compilation, and you can click on the Cancel button inside the compiler 
window to stop compiling the file immediately. If you choose Check 
Procedure Syntax from under the Service menu, the compiler will perform 
normally except that it will not create a compiled object code file. 


During compilation, the last several lines that have been compiled will be 
shown in the center of the compiler window. The bottom-most line is the one 
being currently compiled. Any error messages you may see refer to the bottom- 
most line displayed. 


Because the syntax of Procedure commands is very consistent, there aren't that 
many different kinds of errors that can happen during compilation (only eight). 
Most of the time, simple observation of the offending line will disclose a spelling 
error. 
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refer to the chapters covering this before proceding. 


We will use the PUTPARAM Procedure command to change 3 bytes in the 
Settings File. Byte number 142, when non-zero, tells Red Ryder that an 
additional font is to be listed under the Font menu when the Set Font... choice 
is selected under the Local menu when VT100 or VT52 emulation is being 
used. The next two bytes (143 and 144) contain the high and low values of the 
font number to display in the menu. You can get the proper font number for 
these values by selecting the font while using TTY emulation - the font number 
is displayed at the top of the point size selection dialog box. 


To get the high and low values to put into bytes 143 and 144, take the font 
number and divide it by 256. This is the high value. Next, take the high value, 
multiply it by 256, and subtract that number from the font number. The 
remainder is the low value. Unless you're a programmer, this is all more than 
likely gobbledegook (which | dare any spelling checker to recognize), which is 
alright, because unless you're a hacker-type into creating your own fonts, | 
would highly suggest you use the Monaco font, which is monospaced, comes in 
9 and 12 point sizes, and contains all of the international, diacritical, and specia! 
characters you're likely to ever need. 


To install the Monaco font, the following Procedure is compiled and executed: 


(Tell Red Ryder we've got an additional font for VT52/VT100) 
PUTPARAM 142,1 

(Monaco font is number 4, so the high value is zero) 
PUTPARAM 143, 0 

(The low value is 4) 

PUTPARAM 144, 4 


if you decide later on to get rid of this, you can compile the following Procedure: 


(Tell Red Ryder not to use any additional VT52/VT100 font) 
PUTPARAM 142,0 


When an additional font is installed, Red Ryder will use that font for all 
characters except: 

1) Boldfaced ASCII characters 

2) Special VT52/VT100 Graphics or U.K. character set characters 
in which case it will use the correct characters contained in the TTY-VTS2- 
VT 100 font. š 
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file, they do not affect execution speed of the Procedure. Therefore, it's wise to 
make liberal use of comments in your source code file. Don't try to put a 
comment after a command on the same line, as in: 

MBAR 3 (Show the Macros Status Bar set #3) 

as this would be construed by the compiler as a syntax error. Instead, put the 
comment directly before or after the line it describes, whichever suits you best. 
(Show the Macros Status Bar set #3) 

MBAR 3 

By the way, the right parenthesis at the end of a comment is not necessary, but 
does makes the source code prettier and more readable. 


It is often desirable to branch to different locations in the Procedure File 
depending on what the remote machine does. We use labels to mark the 
locations that can be branched to in a Procedure File. A label definition (where 
execution will branch to) begins with a colon, followed by the label name. The 
label name may be as long as you like (as long is it follows the 79 character 
Procedure line limit), but only the first 20 characters are significant. The label 
name can contain any characters, including spaces. Here are two examples of 
label definitions as they might appear in a Procedure source code file: 


(The following line is a label definition) 
:FIRST 

BELL 

JUMPTO SECOND 

END 

(The following line is a label definition) 
:SECOND 

GOSUB THIRD 

END 


In this example, the labels FIRST and SECOND are defined. Two commands, 
JUMPTO SECOND and GOSUB THIRD, make references to labels. Notice 
that the colon is not included in a label reference. If you've got a sharp eye, you 
probably realize that this Procedure would not compile correctly because the 
label THIRD was referenced but never defined. Labels can be defined but not 
referenced, but the reverse is a no-no. 


Parameter Types 
There are several different parameter types used by Procedure commands: 


Label 
A label, as described above, is abbreviated in Procedure command listings as 
LABEL. 
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start easy, and work their way to complex. The beauty of it is that you can make 
your procedures as simple or complex as suits your needs and ingenuity, so 
don't overdo it by moving too fast. | 


You can execute a Procedure file in a number of ways: 


« By choosing Initiate Procedure... from under the Service menu and 
selecting the compiled Procedure File to execute. 


« By double-clicking the mouse button (or single-clicking and choosing Open 
from the Finder's File menu) on a compiled Procedure File icon in the Finder. If 
you start up Red Ryder this way, the Procedure file will be immediately 
executed. 


« By naming a compiled Procedure File with the special name "RRJ$" (without 
the quotes) on the same disk (or in the same HFS folder) as Red Ryder - Red 
Ryder will execute this file immediately upon starting up. If you create one of 
these, don't start up Red Ryder by double-clicking a Procedure file icon as only 
the RRJ$ Procedure will be executed. The RRJ$ file can be used to bypass the 
title screen, or to set up a default configuration you like instead of using one left 
over from the last session contained in the "Red's 10.x Stuff" Settings File. 


* By using the Host Mode command DO, which is explained in detail in the 
chapter "Host Mode". There is also a Procedure File command DO for 
executing one Procedure File by another. 


« Through a macro key. The first character of the macro key should be a 
backslash ("\") followed by the Procedure filename. Don't get the backslash 
confused with the slash ("7). Installing a Procedure File filename into a macro 
key is explained in the chapter "The Macros Status Bar". 


¢ Through a Phonebook entry, which is explained in the chapter "Phonebooks". 


During the execution of a Procedure File, the title bar of the Terminal Display 
Window will show the filename of the Procedure File executing. If at any time 
you wish to cancel a Procedure File in progress, you will find that the Initiate 
Procedure... choice under the Service menu has changed into Cancel 
Procedure. Choose Cancel Procedure, and execution will end 
immediately. 


if the Monitor Procedure choice is checkmarked under the Service menu, 
Procedure commands are shown in the Status Bar area as they are executed to 
let you see what is happening. Because of the nature of compiled files, some of 
the commands (like the JUMPTO and GOSUB commands) that are shown 
may differ from the way they appear in the source code. The Monitor 
Procedure command may be overridden with the QUIET and LOUD 
commands during the Procedure's execution, and it will always be 
automatically uncheckmarked and disabled in the Service menu (for security 
reasons) whenever an encrypted Procedure File is executed. 
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String Variable 
A string variable is abbreviated in Procedure command listings as STR_VAR. A 
string variable is a capital letter from A to Z followed by a dollar sign. There are 
therefore 26 available string variables. String variables are used to hold a 
string constant or a character constant, and can hold up to 132 characters, 
which is by no coincidence the size of the longest line Red Ryder can display in 
its Terminal Display Window. There are also 3 special string variables referred 
to as @ variables, because they are designated as the @ symbol followed by a 
0,1,0r2. @ variables are used by certain Procedure commands for 
displaying information to the user in a Special Status Bar. They are just like 
string variables, but have a limit of 80 characters. String variables retain their 
values even after a Procedure stops execution so that they can be used to pass 
values between different Procedure Files. 

Examples: 


Numeric Expression 
A numeric expression is abbreviated in Procedure command listings as 


NUM EXP. Anytime you see a numeric expression parameter, it means that you 
can use your choice of either a numeric constant or a numeric variable for that 
parameter. 


String Expression 
A string expression is abbreviated in Procedure command listings as STH EXP. 


Anytime you see a string expression parameter, it means that you can use your 
choice of either a string constant, string variable, @ variable, or character 
constant. 


Numeric Test rator 

A numeric test operator is abbreviated in Procedure command listings as 
NUM TEST. OP. There are eight different symbols that can be used where a 
numeric test operator is specified. They are: 

» (Greater than) 

« (Less than) 

= (Equal to) 

<= (Less than or equal to) 

>= (Greater than or equal to) 

<> (Not equal to) 

& (Binary AND) 

| (Binary OR) 
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Numeric Constant 

A numeric constant is abbreviated in Procedure command listings as 

NUM. CON. It is a number from -2,147,483,648 to 2,147,483,647. Although this 
is a huge range of numbers, a numeric constant must be a whole number, not a 
decimal or fraction. 

Examples: 

123 

10 

-200 

0 

44 


haracter nstant 
A Character constant is abbreviated in Procedure command listings as 
CHAR CON. A character constant is a single capital letter from A to Z. 
Examples: 


NOOO > 


Strin nstant 

A string constant is abbreviated in Procedure command listings as STR_CON. 
A string constant is a group of one or more alphanumeric characters. Typed 
spaces are considered by the compiler to be a valid part of the string constant. 
Examples: 

H 


HE 

HELLO THERE 
H1234 

23ZZH 
Numeric Vari 


| 
A numeric variable is abbreviated in Procedure command listings as 
NUM_VAR. A numeric variable is a capital letter from A to Z followed by a 
percent sign. There are therefore 26 available numeric variables. Numeric 
variables are used to hold a numeric constant, and therefore have the same 
range as numeric constants of the size of numbers they can hold. Numeric 
variables retain their values even after a Procedure stops execution so that they 
can be used to pass values between different Procedure Files. 
Examples: 
A% 
B% 
C% 
D% 
Z% 
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MELTDOWN NUM VAR,NUM EXP 
Description: This command blows up the Macintosh attached at AppleTalk 
node number NUM VAR only if NUM EXP is a negative number. Otherwise, it 
merely laughs at you. 

Example: 

TYPE Thar she blows! 

MELTDOWN A%,-23 

SEE ALSO: SELFDESTRUCT, CHERNOBYL. 

Refer to Example #2 and #23 for sample usage of "MELTDOWN". 


The first line gives the syntactic description of the command with the command 
itself in boldface and the parameter list (if any) in plain face type. The 
parameters are listed in order, with any delimiting characters shown - in the 
above example, we know that NUM VAR and NUM EXP must be separated 
with a comma. If two or more parameters are of the same type, the parameters 
are numbered to differentiate them, as in NUM VAR1 and NUM VAR. If a 
parameter is optional (meaning it can be left out in the source code and Red 
Ryder will use a described default value), it is enclosed with square brackets. 
Next comes a description of what the command does and what each parameter 
designates. Next, a list of any Procedure commands used in conjunction with 
the described command is presented for you to cross reference. Finally, a short 
example usage may be given, and/or any examples of the command usage in 
the chapter "Procedure File Examples" are cross referenced for you to examine. 


The Procedure commands are separated into 9 categories grouped according 
to primary function, and are for the most part listed alphabetically under each 
category. Whenever two or more commands are used in conjunction, they are 
listed together. The categories are: 


* Screen And Keyboard Input And Output 
e Variable Manipulation 

* File Transfers 

* Disk File Manipulation 

* Printer Manipulation 

« Settings Manipulation 

* User Defined Menus 

* Procedure Execution Modifiers 

* User Defined Dialog Box Commands 


Final Hints And Tips 

Always put a PAUSE command after a PROMPT command. Many remote 
systems need a moment or two to settle down before you deluge it with 
characters, such as through a TYPE command. 


If you just can't make a PROMPT command work, you're probably doing one of 
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— 
An on or off expression is abbreviated in Procedure command listings as 
ON OR OFF EXP. Where an on or off expression is specified, you should 
supply either the word ON or the word OFF. 


Filetype Expression 
A filetype expression is abbreviated in Procedure command listings as 


FILETYPE EXP. A filetype expression is used to specify a four character file 
type as used by the Finder. Therefore, it is four alphanumeric characters. 
Examples: 

AAAA 

2222 

MACA 

WORD 

EDIT 


Procedure Comman 

A Procedure command is abbreviated in Procedure command listings as 
PROC CMD. Certain Procedure commands are actually made up of two 
Procedure commands. If a certain condition exists (depending on the 
command) the second Procedure command is executed, otherwise it is not 
executed. For example: 


IF YES JUMPTO PROCESS 


is actually constructed of two Procedure commands, IF YES and 
JUMPTO PROCESS. If the "yes" condition exists (which is explained in more 
detail later), the JUMPTO PROCESS command is immediately executed. 


Flags 

There are two internal flags used by some Procedure commands. These flags 
are used to reflect a certain result of an operation, so that the Procedure 
execution may branch to perform certain instructions based upon what has 
happened thus far. The first flag is referred to as the YES/NO flag. It is either 
set to a "YES" condition, or a "NO" condition. The second flag is called the 
ERROR flag. It is either set to an "ERROR" condition, or a "NO ERROR" 
condition. How and where these commands are used are described in the next 
chapter in the descriptions of Procedure commands that affect or use them. 
Both flags retain their values even after a Procedure stops execution so that 
they can be used to pass information between different Procedure Files. 


Whenever a Procedure File is executed, the Error flag is set to "NO ERROR", 
and the Yes/No flag is set to "YES". 


How Procedur mmands Are Document 
In the next chapter, each Procedure Command is documented as in the 
following fictitious command example: 
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* Show compiler window during compilation: Because of the overhead 
involved in printing each line as it is compiled (as well as its corresponding line 
number), you can improve the speed of compilation by uncheckmarking this 
option. When not checkmarked, the compiler window is not shown during 
compilation, and errors are signalled only by a beep sound. In that event, you 
could then turn this option back on and then recompile to find out where and 
what the error was that was signalled. 


OK, let's look at the individual Procedure commands. Remember: first time 
through don't get overwhelmed, just browse. Then, look over the examples, 
and come back to the descriptions to see how they're being used, or when you 
have a need for one in a Procedure you're writing. | 
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three things: 

1) Not prompting for the correct string ("YOU HAVE MAIL", "You Have Mail" and 
"you have mail" are three different strings because of the upper and 
lowercase letters). 

2) Inserted a leading, trailing, or unneeded space in the string. 

3) Never receive the string you are prompting for. 


In 99% of the cases where somebody says "my Procedure won't work", the 
problem has been traced to a faulty PROMPT command. Please, please check 
these very carefully before calling for help. 


Unless a Procedure is ended by a command (such as QUIT, RUN, or DO), it 
will stop normally after executing the physically last Procedure command line or 
when an error occurs. Although not all of the Procedure commands are used in 
the "Procedure File Examples" chapter, each command is given a short usage 
example in its listing in the "Procedure Commands". 


Remember that a string or numeric expression can be either a constant or a 
variable, but not a combination of both. If you wanted to type a constant, a 
variable, and finally a carriage return, the command: 

TYPE This is my name: AS^M 

would not work. It would need to be broken up into the commands: 

TYPE This is my name: 

TYPE AS 

TYPE ^M 


A number of things about how Red Ryder compiles your source code into 
Procedure Files can be modified by choosing Procedure Compiler 
Preferences from under the Customize menu. They are: 


e Compiler encrypts procedure files: If this option is checkmarked, a very 
devious scheme of encryption is used on the Procedure File, which renders the 
file impervious to the likes of file editing programs and pseudo-hackers 
searching for password strings in the file. If you choose encryption, the 
Monitor Procedure choice under the Service menu is uncheckmarked and 
disabled when the Procedure File is executed. Only explicit LOUD Procedure 
commands will allow tracing of an encrypted Procedure File. 


- Max. number of label definitions: This value tells Red Ryder how much 
memory to set aside to keep track of label definitions while compiling. If you get 
"ERROR: Out of label definition space" errors from the Procedure compiler, you 
should increase the number in this value. 


+ Max. number of label references: This value tells Red Ryder how much 
memory to set aside to keep track of label references while compiling. If you get 
"ERROR: Out of label reference space" errors from the Procedure compiler, you 
should increase the number in this value. 
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disabled. There is a single space between the "ALERT" number (1, 2; Or 
3) and STR_EXP, but no spaces between STR_EXP, the slash character, and 
PROC CMD. Don't confuse the slash character "/", with the backslash 
character "\". 

SEE ALSO: PROMPT, PROMPT ^ 

Example: Refer to Example #2 in the chapter "Procedure File Examples" 
for sample usage of "ALERTI". 


Description: Causes the Macintosh to emit a short beep sound. Useful to 
alert you audibly during various stages of a Procedure execution. 
Example: 

TYPE One ringy-dingyl^M 

BELL 


Description: Clears all lines of text in the Terminal Display Window. 
Example: 

COMM 300-N-8-1-FULL 

DIAL ATDT 555-1212 

PROMPT CONNECT 

CLEAR ~ 


DIAL STR EXP 

REDIAL STR EXP 

Description: These commands work just like the Dial Or Redial A 
Number choice under the Service menu. You can embed control 
characters in STR_EXP just as you would in a Macro Key, but you don't 
need to put a ^M at the end (the carriage return is supplied 
automatically). STR EXP must be 70 characters long or less. Many 
people will point out that this and the "TYPE" command are similar. 
They are with two exceptions: a number dialed using the "DIAL" or 
"REDIAL" commands rather than the "TYPE" command can be redialed at a 
later time by choosing the Dial Or Redial A Number choice under the 
Service menu and you would have to explicitly place a *M at the end of 
STR EXP if you used a "TYPE" command. 

Example: 

COMM 300-N-8-1-FULL 

(Make sure the modem is ready) 

TYPE AT^M 

TYPE AT^M 

TYPE AT^M 
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PAUSE 
DIAL ATDT 555-1212 


LONG BREAK 

SHORT BREAK 

Description: The "LONG BREAK" command is used to send a long (3 1/2 to 
4 second) modem break signal, and is functionally equivalent to a 

"TYPE ^Q" command. The "SHORT BREAK" command is used to send a short 
(233 millisecond) modem break signal, and is functionally equivalent to 
a "TYPE ^!" command. 
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GETLINE NUM EXP,STR VAR 

Description: The "GETLINE" command is used to read a line of text 
directly from the Terminal Display Window into a string variable. 

NUM EXP must be a positive number from 1 to 24, and is the line number 
of the last 24 lines received (the most recently received line being 
line number 24) you wish to read into the string variable STR VAR. 
Example: 

(Read in line #1 to variable Aj) 

GETLINE 1,A5 


PROMPT “CHAR CON 

Description: The "PROMPT 4" command works just like the regular 
"PROMPT" command, except that it is used to look for a single control 
character to come over the serial port, rather than a string of 
characters. CHAR CON is an uppercase letter from A to 2, representing 
the control character you wish to look for. Execution of the Procedure 
stops until the control character is received. Once the control 
character is received, execution of the Procedure continues normally. 
Example: 

(Wait for a carriage return (CTRL-M) before continuing) 

PROMPT ^M 

(Some systems choke if we type something right after they send gatar) 
(so we'll put a short PAUSE here to let 'em settle down) 

PAUSE 

TYPE And away we go... 


~~ oe ee eee mds ee a mdi eee eee e oe Wii 


PROMPT STR EXP 
Description: The "PROMPT" command is used when you want a Procedure to 
hold up until a certain string of characters (designated in STR EXP) to 
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be received before the next command is executed. STR_EXP can be up to 
20 characters long. Upper and lower case are considered significant, 
and must match between STR EXP and the string of characters received in 
order to be recognized as a match. Control characters may not be 
embedded in STR EXP (use the PROMPT ^). 

Example: 

(Dial a phone number, wait for the CONNECT message from my modem, and) 
(then type my password and a carriage return) 

DIAL ATDT 555-1212 

PROMPT CONNECT 

(It's always a good idea to put a short delay in before typing) 

PAUSE 

TYPE My-Password^M 


TYPE STR EXP 

Description: The "TYPE" command is used to simulate typing on your 
keyboard. In other words, if you want the Procedure to send a certain 
string of characters, you put that string of characters in STR EXP. 

STR EXP can be a mixture of reqular and control characters, just as is 
allowed in a Macro Key. Four special character strings can be placed in 
STR EXP to yield the following functions: 


sequence Function 
"5 Sends a DEL character {ASCII code 127) 
^ Sends a short modem break signal 
na Sends a long modem break signal 
^d Drops the DTR serial port line for 1 second 


These sequences don't have to appear alone, they can be embedded within 
a STR EXP's characters. 

Example: 

(Type the string HELLO followed by a carriage return (CTRL-M) 

TYPE HELLO^M 

(And send a short modem break signal) 

TYPE ^! 


— u a m ma m e e e a e o ended eee e d 


WATCH ON-OR OFF EXP 

Description: The "WATCH" command is used to turn the mouse cursor into 
a watch cursor, which is the standard Macintosh indicator that a certain 
function will require the user to wait. Because other parts of Red 
Ryder can take the watch cursor "out from under you" in changing it back 
to other things (like the I-beam cursor in the Buffered Keyboard status 
bar or the normal arrow cursor if the mouse is moved over the text 
display area of the Terminal Display Window), it is recommended that the 
"WATCH" command be used only when your Procedure is in a tight loop, as 
during a locked condition (see the "LOCK" command below) or during a 
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compilation (see the "COMPILE LOUD" and “COMPILE QUIET" commands 
below). | 

Example: 

(Turn the cursor into a watch during a compilation) 

WATCH ON 

COMPILE QUIET MYDISK:MYPROCEDURE 

(When we get to the next instruction, we know that the compile has) 
(finished, so turn the cursor back into an arrow) 

WATCH OFF 


inh AMEND yp e mr i s s ee ee m sn ee Gem m — 


ADD NUM VAR,NUM EXP 

Description: The "ADD" command is used to add the value NUM EXP to the 
value held in NUM VAR. Only NUM VAR is affected by this command. If 
NUM EXP is a numeric variable, that variable is not changed. 

Example: 

(Add 15 to the numeric variable 2%) 

ADD 2$,15 


AND NUM VAR,NUM EXP 

Description: The "AND" command performs a binary AND operation on 

NUM VAR and NUM EXP, and places the result in NUM VAR. Only NUM VAR is 
affected by this command. 

Example: 

(AND in the value 256 to the numeric variable M%) 

AND M$,256 


CONCAT STR VAR,STR EXP 

Description: This command appends (concatentates) the string of 
characters in STR EXP to the end of STR VAR. Only STR VAR is affected 
by this command. If the resulting concatenation would make STR VAR 
longer than 132 characters, any characters past the 132nd are-lopped off 
into oblivion. 

Example: 

COPYINTO AS, HELLO 

(AS now contains the word "HELLO") 

CONCAT AS, THERE 

(Notice the space between the comma and THERE - AS now contains) 

(the string "HELLO THERE") 
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CONTAINS STR VAR,STR EXP 

Description: This command tests to see whether STR VAR contains the 
characters in STR EXP. If it does, it sets the YES/NO flag to "YES", 
otherwise it sets the YES/NO flag to "NO". It does not change either 
STR_VAR or STR_EXP. Upper and lowercase letters are considered 
different. 

Example: 

(Does the string variable B$ contain the word HELLO?) 

CONTAINS BS, HELLO 

(If it does, ring the bell) 

IF YES BELL 


CONVUP STR VAR | 
Description: This command converts any lowercase letters in STR VAR to 
their uppercase equivalent. 

Example: 

COPYINTO A$,Hello There 

(The string variable A$ now contains the string "Hello There". Let's) 
(convert the lowercase letters to uppercase) 

CONVUP AS 

(AS now contains the string "HELLO THERE") 


COPYINTO STR VAR, STR EXP 

Description: This command replaces the current contents of STR_VAR with 
the contents of STR_EXP. Only STR_VAR is changed by this command. 
Example: 

(Put the string of characters "HELLO" into the string variable A$) 
COPYINTO AS, HELLO 

(And copy that string into the string variable B$) 

COPYINTO B$,A$ 
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DIVIDE NUM VAR, NUM EXP 

Description: This command divides NUM VAR by NUM_EXP and places the 
result in NUM VAR. Only NUM_VAR is changed by this command. If a 
division by zero would result, no division is done and the ERROR flag is 
set to "ERROR". Otherwise, the division is done and the ERROR flag is 
set to "NO ERROR". 

Example: 

(Put the value 15 into the numeric variable A%) 
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LET EQUAL A%,15 

(And divide A% by 3) 
DIVIDE A%, 3 

(A$ contains the value 5) 


— a a eee eee ee eee LZ 


ELAPSED NUM VAR | 
Description: This command calculates the number of seconds that have 
elapsed since the last "SAVETIME" command was executed, and places 
that number in NUM VAR. 

Example: 

(Save the current time internally) 

SAVETIME 

(Now introduce a pause of 6 seconds) 

PAUSE 360 

(And calculate the elapsed time) 

ELAPSED A% 

(The numeric variable A% should now hold 6) 


EMPTY STR_VAR 

Description: This command tests to see if STR_VAR is empty (contains no 
characters). If it is, it sets the YES/NO flag to "YES". If STR_VAR 
contains characters, the YES/NO command is set to "NO". STR_VAR is 
unaffected by this command. 

Example: 

(Erase all characters from the string variable A$) 

ERASE A$ 

(Trust me, it is - but let's go ahead and test that it's really empty). 
EMPTY AS 

IF YES BELL 

IF NO TYPE He lied! He lied! 
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ERASE STR VAR 

ERASE ALL 

Description: The command "ERASE ALL" will destroy the contents and 
leave empty all string variables (including the @ variables). To erase 
individual string or @ variables, use the "ERASE" command in 
conjunction with the appropriate STR_VAR parameter. 

Example: 

(Erase all string variables) 

ERASE ALL 

(Erase only the M$ string variable) 

ERASE MS 
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FILLS STR VAR,NUM EXP,STR EXP 

Description: The "FILL$" command replaces the contents of STR VAR with 
NUM EXP number of the first character in STR EXP. Only the contents of 
STR VAR is changed by the "FILL$" command. 

Example: 

(Put the string "HELLO" into the string variable A$) 

COPYINTO AS, HELLO 

(Erase the contents of B$) 

ERASE BS 

(Now put 15 of the first character of AS into BS) 

FILL$ B$,15,A5 

(AS now contains the string "HHHHHHHHHHHHHHH") 


GETGLOBAL NUM VAR, NUM EXP 

Description: The "GETGLOBAL" command is used to obtain the value of 
certain special internal variables not accessable in any other manner. 
These variables are called Global Variables, and are accessed by placing 
the desired Global Variable number (from 0 to 11) into NUM_EXP. The 
value of that Global Variable is then copied into NUM_VAR. The Global 
Variables and values they return are: 


Global # Function 


0 Current emulation (0 = TTY, 1 = VT100, 2 = VT52). 

1 Current cursor row (1 - 24). 

2 Current cursor column (1 - 132). 

3 Current duplex (0 = full, 1 = half, 2 = echoback, 3 = 
null). 

4 Number of 60'ths of a second elapsed since Macintosh was 
started up. 

5 Current month (1 - 12). 

6 Current day (1 - 31). 

7 Current year (1904 - ????). 

8 Current hour (0 - 23). 

9 Current minute (0 - 59). 

10 Current second (0 - 59). 

ET Current day of week (1-7: Sunday - 1). 

Example: 


(Get the day of the week global) 

GETGLOBAL A%,11 

(Find out if today is Monday -> Is A% = 2?) 
TEST A$-2 

(If it is, bang a gong) 

IF YES BELL 


Red Ryder Documentation Page 90 


GETCOST NUM VAR 

Description: This value gets the number of cents currently displayed in 
the billing clocks (in the General and Macros Status Bars) and returns 
that value in NUM_VAR. 

Example: 

(How much have we spent?) 

GETCOST A% 

(A% now holds the amount of money spent in cents) 


INSTR NUM VAR, STR VAR, NUM EXP, STR EXP 

Description: This command returns in NUM VAR the character position 
(from 1 to the length of STR VAR) that the string STR EXP is first found 
in STR VAR. The search for STR EXP begins at postion NUM EXP in 

STR EXP. If the string isn't found, NUM VAR is set to zero. Upper and 
lower case are considered different in the search. 

Example; 

LET EQUAL AS,THE QUICK BROWN FOX IS EVEN QUICKER TODAY 

(Find the first position of the string "QUICK" in A$) 

INSTR A%,A$,1, QUICK 

(A% now equals 5) 

(Get past first QUICK by choosing a starting character as 6, and) 
(find position of the second QUICK string) 

INSTR A%,A$, 6, QUICK 

(A$ now equals 29) 


LEFTS STR VAR, NUM EXP,STR EXP 

Description: This command copies the first (leftmost) NUM EXP characters 
in STR EXP into STR VAR. Only STR VAR is affected by this command. 
Example: 

(Copy the string "HELLO" into AS) 

COPYINTO A$, HELLO 

(Get the first 3 characters in A$ and put them in BS) 

LEFT$ BS,3,A$ 

(BS now contains the string "HEL") 
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LENGTH NUM VAR, STR EXP 

Description: The "LENGTH" command calculates the number of characters 
in STR EXP and returns that number in NUM VAR. Only NUM VAR is changed 
by this command. 

Example: 

(Copy the string "HELLO" into A$ 

COPYINTO AS, HELLO 
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(Now put the size of A$ into A%) 
LENGTH A%,A$ 
(A$ now equals 5) 


LET EQUAL NUM VAR, NUM_EXP 

Description: This command takes the value NUM EXP and copies it into the 
numeric variable NUM VAR. Only NUM VAR is changed by this command. 
Example: 

(Put the value 535 into the numeric variable 2%) 

LET EQUAL 2%,535 


LOADVAR STR EXP 

Description: This command loads from disk a set of saved variables that 
were saved with a previous "SAVEVAR" command. The contents of all 
string and numeric variables are destroyed in favor of the new values. 
The @ variables, however, are unchanged by this command. STR EXP is the 
filename of the file created with the "SAVEVAR" command. WARNING: Do 
not use the "LOADVAR" command with any other file than one created 
with the "SAVEVAR" command! 
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MIDS STR VAR,NUM EXP1, NUM EXP2,STR EXP 

Description: This command copies NUM | EXP2 number of characters from 
STR EXP starting at position NUM. EXP1 into STR VAR. Only STR VAR is 
changed by this command. 

Example: 

(Put the string "HELLO" into AS) 

COPYINTO AS,HELLO 

(Copy the first 2 characters starting at position 3 of AS into B$) 
MID$ BS,3,2,A$ 

(BS now contains the string "LL") 


MULTIPLY NUM VAR,NUM EXP 

Description: This command multiplies NUM VAR by NUM EXP and places the 
result in NUM VAR. Only NUM VAR is changed by this command. 

Example: 

(Put the value 5 into the numeric variable L$) 

LET EQUAL L$,5 

(And multiply L$ by 3) 

MULTIPLY L%, 3 
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(L$ now equals 15) 


NUMTOSTRING NUM VAR, STR VAR 

Description: This command converts the number NUM VAR to a string of 
characters and copies that string into STR_VAR. Only STR_VAR is changed 
by this command. 

Example: 

(Put the value -53 into the numeric variable M$) 

LET EQUAL M%,-53 

(Convert M% to a string and put that in the string variable AS) 
NUMTOSTRING M%,A$ 

(AS now contains the string "-53") 


OR NUM VAR, NUM_EXP 

Description: The "OR" command performs a binary OR operation on NUM_VAR 
and NUM EXP, and places the result in NUM VAR. Only NUM VAR is affected 
by this command. 

Example: 

(OR in the value 256 to the numeric variable Mi) 

OR M%, 256 
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REPLACES STR VAR,NUM EXP1,NUM EXP2, STR EXP 

Description: This command replaces NUM EXP2 number of characters in 
STR VAR starting at position NUM EXP1 with the contents of STR EXP. 
Only STR VAR is changed by this command. If the replacement causes 
STR VAR to be longer than 132 characters, all characters past the 132nd 
in STR VAR are lopped off into oblivion. 

Example: 

(Put the string "HELLO" into the string variable AS) 

COPYINTO AS$,HELLO 

(Replace 2 characters in A$ starting at character $3 with) 

(the string "FOOBAR") 

REPLACES A$,3,2,FOOBAR 

(AS now contains the string "HEFOOBARO") 


RIGHTS STR VAR,NUM EXP,STR EXP 

Description: This command copies NUM EXP number of the last (rightmost) 
characters in STR EXP into STR VAR. Only STR VAR is changed by this 
command. 

Example: 
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(Put the string HELLO into the string variable AS) 
COPYINTO AS, HELLO 

(Copy the last 3 characters in AS to BS) 

RIGETS BS,3,A$ 

(BS now contains the string "LLO") 


SAVETIME 

Description: This command saves the current time in an internal 
variable. It is used in conjunction with a later "ELAPSED" command, 
to calculate how many seconds have elapsed between two points in time. 
Example: 

(Save the current time) 

SAVETIME 

(Now wait until 6:00:00 AM) 

WAIT 06:00:00 

(And put the number of seconds that elapsed between the SAVETIME) 
(command and 6:00:00 AM in the numeric variable A%) 

ELAPSED A% 


SAVEVAR STR EXP Ä 
Description: This command saves the contents of all numeric and string 
variables (except for the three @ variables) into a disk file designated 
by the filename contained in STR EXP. The variables can be later 
restored via a "LOADVAR" command. This command does not change the 
current state of any variables. 


Example: 
(EEK! I've used up all my variables and need one more numeric variable) 


(for a temporary calculation. Better save off my variables, first) 
SAVEVAR MYDISK:THEVARS 

(Now I can do some temporary work with whatever variables I want) 
(without having to worry about destroying anything important) 

LET EQUAL A%,5 

(And so forth...) 

(Now let's bring back my original variables) 

LOADVAR MYDISK:THEVARS 

(And get rid of the temporary file) 

DELETE MYDISK:THEVARS 


STRINGTONUM STR VAR, NUM VAR 

Description: This command converts the string of characters in STR VAR 
to a numeric equivalent and places that number into NUM VAR. Only 

NUM VAR is changed by this command. If STR VAR contains characters of a 
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non-numeric nature, NUM VAR will be set to zero. 

Example: 

(Copy the string "12345" into the seeing variable A$) 

COPYINTO A$,12345 

(Convert A$ to a number and put that number in the numeric variable A%) 
STRINGTONUM AS,A% 

(A% now equals 12345) 


SUBTRACT NUM VAR,NUM EXP 

Description: This command subtracts NUM EXP from NUM VAR and puts the 
result in NUM VAR. Only NUM VAR is changed by this command. 

Example: 

(Put the value 15 into the numeric variable A%) 

LET EQUAL A%,15 

(And subtract 10 from A%) 

SUBTRACT A%,10 

(A$ now equals 5) 


TEST NUM VAR, NUM TEST OP,NUM EXP 

Description: This command does an arithmetic test between NUM VAR and 
NUM EXP (the kind of test is designated by NUM TEST OP) and sets the 
YES/NO flag based on the result of the test. If the test is true, the 
YES/NO flag is set to "YES", otherwise, the YES/NO flag is set to "NO". 
Neither NUM VAR nor NUM EXP is changed by this command. 

Example: 

(Put the value 15 into A$) 

LET EQUAL A%,15 

(Is 15 less than 25?) 

TEST A$«25 

(We know it is, so...) 

IF YES BELL 
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TIMEDATE STR VAR 

Description: This command takes the current time and date, converts both 
into a string of characters, and copies that string into STR VAR. The 
string is in the format "MM/DD/YY HH:MM:SS" 

Exampie: 

(Get the current time and date into the string variable A$) 

TIMEDATE AS 

(AS might now hold something like "06/16/87 23:49:26") 
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File Transfers 


All file transfer commands set the Error flag to either "ERROR" or "NO 
ERROR" to indicate the failure or success of the operation performed. 


CLOSE 

Description: This command is used to terminate the file received started 
by choosing Capture Incoming Data To TEXT File from under the 

File menu, or by using a "RECA" command. If a "CLOSE" command is 
executed when a file capture is not happening, a "Bad Procedure Command" 
will be returned and the Procedure will be halted. 

Example: 

(Capture all incoming data to the file MAIL on the disk MYDISK) 

RECA MYDISK: MAIL 

(And keep capturing until we receive the string "END OF MAIL") 

PROMPT END OF MAIL 

(Now close the capture file) 

CLOSE 


FASTDUMP 

Description: "FASTDUMP" is a feature that was created to solve one 
person's specific and unusual need. It is one of those unique things in 
Red Ryder that cannot be accessed through any other means than through 
this Procedure command, yet it is unlike other Procedure commands in 
that it is not intended to be used unattended and in fact requires a 
certain degree of experience on the user's part. First, let me explain 
the fellow's problem and then what I proposed as an attempted solution 
through the "FASTDUMP" command. 


This fellow had to get a couple of dozen large text files from an 
archaic mainframe onto his Macintosh. The problem was twofold in that 
he had to use 9600 baud and his mainframe did not recognize or support 
any flow control handshaking. My challenge was therefore doubly 
difficult. First of all, Red Ryder simply cannot print 960 characters 
per second on the screen and still support all of its features. 
Secondly, even if Red Ryder could, a mechanical disk drive (floppy or 
hard) presents even further significant overhead. 


My solution was this. I would put in a special Procedure command that 
when executed, would bring up a standard Macintosh file definition 
dialog box. The user would type in the name of the file they wished to 
capture the incoming text to, and then Red Ryder would go into a special 
"Fast Dumping" mode. When in this mode, there would be no visual 
feedback that anything was happening. An extremely tight loop was 
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executing that did nothing more than look for characters coming over the 
serial port, and stuff them into the file as they came. Very tight 
loop. No feedback, no overhead. When the user clicked the mouse 
button, the file would be closed and that was that. 


That's the essence of the "FASTDUMP" command. If ‘used in conjunction 
with a RAM disk (to eliminate mechanical delays from disk drives), it 
was quite simply the fastest possible method to capture incoming data to 
a disk file. In fact, even the parity bits are not stripped, so you 
must use NO parity and 8 databits with this function. 


When the "FASTDUMP" command is executed (it has no parameters, just 
compile a source file with that single command in it), the following 
happens: 

1) You get the file definition dialog box. You type the filename and 
click on the Save button. 

2) A bell rings one time. This tells you that the "FASTDUMP" function 
is ready to receive. 

3) Everything received is stuffed into the file with no modification as 
quickly as possible, until... 

4) When you click the mouse button, the bell rings twice and the file is 
closed. This, of course, means that the sending machine must give you 
some indication of when the file has been entirely sent, so you know 
when to click the mouse button. 


You will probably never need the "FASTDUMP" command. If you ever do, 
you will bless Red Ryder for having it available. 
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RECA STR EXP 

Description: This command is equivalent to choosing Capture Incoming 
Data To A TEXT File from under the File menu. To close the file, 
the "CLOSE" Procedure command is used. STR_EXP is the filename that 
data is captured to. 


RECK STR EXP 

Description: This command is equivalent to choosing Receive File - 
Kermit from under the File menu. STR EXP is the filename that the 
data is received to. 

Example: 

(Receive the file JUNK to the disk MYDISK using Kermit protocol) 
RECK MYDISK: JUNK 
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RECX STR EXP 

Description: This command is equivalent to choosing Receive File - 
XMODEM from under the File menu. STR_EXP is the filename that data is 
received to. 

Example: 

(Receive the file JUNK to the disk MYDISK using XMODEM protocol) 

RECX MYDISK: JUNK 


RECY STR EXP 

Description: This command is equivalent to choosing Receive Batch - 
YMODEM from under the File menu. STR_EXP must be present (as any 
string of characters you desire) but is ultimately ignored. The current 
auto-receive volume is used for the location to save the batch of files 
(whether or not the auto-receive feature is selected - the default is 
the same volume (or HFS folder) that Red Ryder resides in). 

Example: 

(Receive a batch of files - there doesn't have to be a disk) 

(or folder named Junk!) 

RECY Junk 


SENDA STR EXP 
Description: This command is equivalent to choosing Send TEXT File 
from under the File menu. STR EXP is the filename of the file to send. 


SENDK STR EXP 


Description: This command is equivalent to choosing Send File - 
Kermit from under the File menu. STR EXP is the filename of the file 
to send. 
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SENDX STR EXP 


Description: This command is equivalent to choosing Send File - 
XMODEM from under the File menu. STR_EXP is the filename of the file 
to send. 


SENDY STR EXP 

Description: This command is equivalent to choosing Send Batch - 
YMODEM from under the File menu. STR_EXP is the filename of a file 
created with the Create YMODEM Batch choice under the File menu. 
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SENDCLIP 
Description: This command is equivalent to choosing Paste under the 
Edit menu. It sends the contents of the Clipboard to the serial port. 


Disk File Manipulation 


COMPILE LOUD STR EXP 

COMPILE QUIET STR EXP 

Description: The "COMPILE LOUD" and "COMPILE QUIET" commands are 
used to compile a Procedure source code file into an executable 
Procedure File. "COMPILE LOUD" shows the Compiler Window during the 
compilation, while "COMPILE QUIET" does not. It is suggested that 
you consider using the "WATCH" command to change the mouse cursor into 
a watch {and later back to the normal arrow) before doing a “COMPILE 
QUIET" in order to notify the user of a brief delay. The compiled 
Procedure File is given the same filename as the source code file, with 
the suffix ".PROC" appended. Both "COMPILE LOUD" and "COMPILE 
QUIET" set the error flag to "ERROR" if an error occurs during the 
compilation, otherwise, the error flag is set to "NO ERROR". 


DELETE STR EXP 

Description: This command is used to delete a disk file, STR_EXP is the 
filename of the file to delete. No confirmation of the deletion is 
done, so please be sure that STR_EXP is a file that you are sure you 
wish to destroy. 


-—— ep Ao A0 eee eee X. “N. “- s“ å å å AO e - 


GETALL 

GETSELECT FILETYPE EXP 

Description: The "GETALL" and "GETSELECT" commands are used to 
specify what kinds of files the "GETFILE" command will allow the user 
to select from in the standard file selection dialog box.  "GETALL" 
(the default- state Red Ryder starts up with) means that all file types 
are acceptable.  "GETSELECT" allows you to limit the files that may be 
chosen to those of type FILETYPE EXP. 

Example: 

(Allow the user to choose any file on the disk) 

GETALL 

GETFILE AS 

(Limit him to choosing only files of type "TEXT") 
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GETSELECT TEXT 
GETFILE AS 
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GETFILE STR VAR 
Description: This command puts up the standard file selection dialog box 
for the user to choose a file. The filename is returned in STR VAR. 
Since the filename must fit in a string variable, the dialog won't let 
the user choose a file which has a filename of more than 132 characters. 
If the user clicks on the "Select" button, the YES/NO flag is set to 
"YES". If the user clicks on the "Cancel" button, the YES/NO flag is 
set to "NO". 

Example: 

(We want the user to choose a TEXT file, so...) 

GETSELECT TEXT 

(Now put up the standard file selection dialog box) 

GETFILE A$ | | 

(If he clicks on the "Cancel" button instead of choosing a file, the) 
(YES/NO flag is set to "NO", and we'll just quit) 

IF NO END 

(Otherwise, the full filename he chose is now in the A$ string variable) 


PUTFILE STR VAR 

Description: This command puts up the standard file definition box, 
which prompts the user to type a filename to create and specify where to 
create it at. The file is not actually created with this command, to do 
that, follow up with a "USEROPENO" command. The full filename is 
returned in STR VAR. If the user clicks on the "Save" button, the 
YES/NO flag is set to "YES". If the user clicks on the "Cancel" 
button, the YES/NO flag is set to "NO". 

Example: 

(Let's find out what to name a file and where to put it) 

PUTFILE A$ 

(If he clicked on the "Cancel" button, the YES/NO flag is set) 

(to "NO", and we'll just quit there) 

IF NO END 

(Otherwise, the filename to create is contained in A$) 


RENAME STR VAR, STR EXP 

Description: This command allows you to rename a disk file toa 
different name. STR_VAR contains the original filename, and STR_EXP 
contains the filename you wish that file to be changed to. This command 
cannot be used to move a file from one disk (or HFS folder) to another 
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location, but just to change its name at its present location. 
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SCREENDISK 

Description: This command is equivalent to clicking in the “Send 
Screen To “Archived Screens" File Button" in the General Status 
Bar. 

Example: 

(Take a "snapshot" of the Terminal Display Window and put it in the) 
("Archived Screens" text file) 

SCREENDISK 


Disk File Input And nern 


There are two user "paths" that may be open at one time for use with the 
following commands, They are known as path 1 and path 2. When you open 
a file for reading or writing, you assign it one of the unused paths. 
When you close a file, that path then becomes available for use with 
another file. In other words, you can have up to two file open for 
reading and writing at the same time. All paths are closed at the 
termination of a Procedure File, For an example of how these commands 
are used in an actual Procedure File, see Example #3 in the chapter 
"Procedure File Examples". 


USERCLOSE NUM EXP 

Description: Closes path number NUM EXP and makes that path available 
for a "USEROPENI", "USEROPENO", or "USEROPENA" command. If the 
path is not currently open, this command does nothing - so use it if 
you're at a place in your Procedure where you're not sure if a path is 
in use or not. 


USEROPENA NUM EXP,STR EXP 

Description: Opens the filename STR EXP using path number NUM EXP for 
Append. Append means that if the file doesn't exist, it will be created 
as a new and empty file. If it does exist, any further "USERWRITE" or 
"USERWRCR" commands will be done at the end of the file, so previous 
data is not destroyed. If the file can't be created, the Error flag is 
set to "ERROR", otherwise, it's set to "NO ERROR". 


USEROPENI NUM EXP,STR EXP 
Description: Opens the filename in STR EXP using path number NUM EXP for 
Input. Input means that you'll be using only "USERREAD" commands with 
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that path, not "USERWRITE" or "USERWRCR" commands. If the file 
doesn't exist, the Error flag is set to "ERROR", otherwise, it's set to 
"NO ERROR". 


USEROPENO NUM EXP,STR EXP 

Description: Opens filename in STR EXP using path number NUM EXP for 
Output. Output means that you'll be using only USERWRITE and USERWRCR 
commands with that path. If "filename" already exists, it will be 
destroyed and recreated as an empty file by this command. If the file 
can't be created, the Error flag is set to "ERROR", otherwise, it's set 


to "NO ERROR". 


USERREAD NUM EXP,STR VAR 

Description: The procedure disk Input/Output commands are meant to be 
used with text files that have lines that are a maximum of 132 
characters long each and end with a carriage return. This command reads 
data from path number NUM EXP (a file opened with the "USEROPENI" 
command) either up to 132 characters or the first carriage return (the 
carriage return is discarded). The data is copied into the specified 
string variable STR VAR. If the read is unsuccessful (most likely 
because you've reached the end of the file) the Error flag is set to 
"ERROR", otherwise it's set to "NO ERROR". 


USERWRCR NUM EXP 

Description: Writes a single carriage return to path number NUM EXP (a 
file opened with either the "USEROPENA" or "USEROPENO" commands), 
effectively terminating a line for later input by the "USERREAD" 
command. 


USERWRITE NUM EXP,STR EXP 

Description: Writes the data in STR EXP to path number NUM EXP (a file 
opened with either the "USEROPENA" or "USEROPENO" commands). It does 
not write a carriage return at the end of that data, so be sure and use 
"USERWRCR" commands where necessary. If the write was unsuccessful 
(path hasn't been opened, disk full, etc.), the Error flag is set to 
"ERROR", otherwise it's set to "NO ERROR". 


Printer Manipulation 
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ECHO ON OR OFF_EXP 

Description: This command is equivalent to choosing Echo Incoming To 
Printer under the Local menu. ON OR OFF EXP controls whether or not 
echoing should be turned on or off. 

Example: 

(Start sending everything that comes over the serial port to the) 
(printer now) 

ECHO ON 
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SCREENPRINT 

Description: This command is equivalent to clicking the "Send Screen 
To Printer" button in the General Status Bar. 

Example: 

(Send a "snapshot" of the Terminal Display Window to the printer) 
SCREENPRINT 


WRITE STR EXP 

Description: This command is equivalent to choosing Print TEXT File 
under the Local menu. -The filename of the file to print is supplied in 
STR EXP. 


Settings Manipulation 
ANSWERBACK STR EXP 
Description: This command changes the VT100 Answerback Message (which is 
displayed in the dialog box brought up by choosing VT100 Modes under 
the Customize menu) to STR EXP. STR EXP may contain control 
characters. 
Example: 
(Change the answerback message to "Hello" followed by a carriage return) 
ANSWERBACK Helio^M 
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Description: Thís command is equivalent to choosing Buffered Keyboard 
from under the Local menu. 

Example: 

(Activate the Buffered Keyboard) 

BBAR 
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COMM STR EXP 

Description: This command is used to change the serial port settings for 
baud rate, parity, data bits, stopbits, and duplex. STR_EXP is in the 
form: 

BAUD-PARITY-DATABITS-STOPBITS-DUPLEX 

where: 

BAUD may equal 300, 450, 1200, 2400, 4800, 9600, 19200, or 57600. 
PARITY may equal N, O, E, K, or S 

DATABITS may equal 5, 6, 7, or 8 

STOPBITS may equal 1, 1.5, or 2 

DUPLEX may equal FULL, HALF, ECHO, or NULL 

Example: 

(Set the serial port to 1200 baud, NO parity, 8 data bits, 1 stopbit,) 
(and FULL duplex) 

COMM 1200-N-8-1-FULL 


CONTROL1 “CHAR CON 
CONTROL2 “CHAR CON 

CONTROL3 “CHAR CON 

Description: These three commands modify the Control Character 
Buttons in the General Status Bar. The buttons are designated #1, 
#2, and #3 from left to right. CHAR CON should be an uppercase letter 
from A to 2. 

Example: 

(Set up the three Control Character Buttons to be CTRL-A, CTRL-B, } 
(and CTRL-C) 

CONTROLI ^A 

CONTROL2 ^B 

CONTROL3 ^C 
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CRC ON OR OFF EXP 
Description: This command is analogous to the "Use and recognize CRC 
error checking" option in the dialog box brought up by choosing 
XMODEM And Kermit Preferences from under the Customize menu. A 
"CRC ON" command would checkmark that option, and a "CRC OFF" command 
would uncheckmark it. 

Example: 

(Turn on CRC error checking) 

CRC ON 
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DELKEY ON OR OFF EXP 

Description: This command is analogous to the "Backspace key is DEL 
key" option in the dialog box brought up by choosing Keyboard 
Mapping Preferences from under the Customize menu. A "DELKEY ON" 
command would checkmark that option, and a "DELKEY OFF" command would 
uncheckmark it. 

Example: 

(Make the backspace key a DELETE key (sends ASCII code 127)) 

DELKEY ON 

(Make the backspace key normal (sends ASCII code 8)) 

DELKEY OFF 


DISPLAY NUM EXP 
Description: This command is analogous to the “Display columns" 
option in the dialog box brought up by choosing Terminal Emulation 
Preferences from under the Customize menu. NUM_EXP must be a number 
between 20 and 132. 

Example: 

(Give me an 80 column display) 

DISPLAY 80 


ALT ON OR OFF EXP 

Description: This command is analogous to the "` key sends ASCII 
code: 'X'" option in the dialog box brought up by choosing Keyboard 
Mapping Preferences from under the Customize menu. A "ALT ON" 
command would checkmark that option, and a "ALT OFF" command would 
uncheckmark it. This command does not change the ASCII code number 
portion of that option. 

Example: 

(I've got 27 in the ASCII code number portion of that option,) 

(so turn on the ` key so that it works like an ESCAPE key) 

ALT ON 
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FONT NUM EXP1,NUM EXP2 

Description: The "FONT" command is used to change the font and/or point 
size currently used in the Terminal Display Window. NUM EXP1 is the 
font number to use, and NUM EXP2 is the point size to use. If the font 
number or point size isn't available, this command has no affect. How 
does one find out the font number? It is displayed at the top of the 
point size selection dialog box when you choose Set Font from under 
the Local menu, and then choose a font from under the Font menu. For 
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instance, if I choose the Monaco font, the top of the pdint size 
selection dialog box would display the message: 

Select the point size for use with the font 

"Monaco" (font number 4) 


Example: 
(Use Monaco (font number 4) font, 9 point size) 
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Description: This command is equivalent to choosing General Status 
Bar under the Local menu. 

Example: 

(Display the General Status Bar) 

GBAR 
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LF ON OR OFF EXP 

Description: This command is analogous to the "Return key sends:" 
option in the dialog box brought up by choosing Keyboard Mapping 
Preferences from under the Customize menu. A "LF ON" command is 
equivalent to clicking the "carriage return and linefeed" radio 
button, and a "LF OFF" command is equivalent to clicking the "carriage 
return only" radio button. 

Example: 

(Return key sends a carriage return followed with a linefeed) 

LF ON 


LOADSET STR EXP 

Description: This command is equivalent to choosing Load Settings 
From Disk from under the Customize menu. STR EXP is the filename of 
the Settings File to load. 

Example: 

(Load the Settings File "BBS Settings" which is on the disk "MYDISK") 
LOADSET MYDISK:BBS Settings 
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LOUD | 
Description: This command is equivalent to checkmarking the Monitor 
Procedure choice under the Service menu. 

Example: 

(Start monitoring the Procedure command execution) 

LOUD 
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MACRO STR EXP 

Description: This command is equivalent to choosing Load Macro Keys 
From Disk from under the Customize menu. STR EXP is the filename of 
the Macro Key file (created by choosing Save Macro Keys To Disk 
under the Customize menu) to load. 

Example: 

(Load in the Macro Key file "BBS Macros" on the disk "MYDISK") 

MACRO MYDISK:BBS Macros 


MBAR [NUM EXP] 

Description: This command is equivalent to choosing Macros Status Bar 
under the Local menu. NUM EXP is optional. If it is not supplied, the 
current active set is displayed. Otherwise, NUM EXP must be either 1, 
2, or 3, which changes the current active set to that number. 

Example: 

(Display the Macros Status Bar, set #2) 

MBAR 2 
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MODEM 

Description: This command instructs Red D icm to communicate through the 
modem serial port. 

Example: 

(Use the modem port) 

MODEM 
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NOZAP ON OR OFF EXP 

Description: This command is analogous to the "Don't zap high bits 
(allow international characters)" brought up by choosing Personal 
Preferences from under the Customize menu. A "NOZAP ON" command 
would checkmark that option, and a “NOZAP OFF" command would 

. uncheckmark it. BE SURE TO READ THE WARNING ABOUT THAT OPTION IN THE 
CHAPTER “Using International Or Special Character Sets" BEFORE USING 
THIS COMMAND! 

Example: 

(Don't zap the high bits) 

NOZAP ON. 
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PRINTER 

Description: This command instructs Red Ryder to communicate through the 
printer serial port. 

Example: 

(Use the printer port to communicate through) 

PRINTER 


QUIET 

Description: This command is equivalent to uncheckmarking the Monitor 
Procedure choice under the Service menu. 

Example: 

(Stop monitoring Procedure command execution) 

QUIET 
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REDIAL LIMIT NUM EXP 

Description: This command is equivalent to the "Redial Limit: 'X' 
tries" option in the dialog box presented when you choose Dial Or 
Redial A Number under the Service menu. NUM EXP should be a number 
between 1 and 255, or zero if you wish there to be no limit for 
redialing tries. 

Example: 

(Set the redial limit to 15 tries) 

REDIAL LIMIT 15 


RESET 

Description: This command sets the elapsed time clock to 00:00:00 and 
the billing clock to $0.00. 

Example: 

(First dial our number) 

DIAL ATDT 555-1212 

(Wait for a connection) 

PROMPT CONNECT 

(Now synchronize the elapsed time and billing clocks) 

RESET 


SCREEN ON OR OFF EXP 


Description: This command is analogous to the Hide Terminal Window 
choice under the Local menu. A "SCREEN OFF" command will hide the 
Terminal Display Window (make it invisible), and a "SCREEN ON" command 
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will make the Terminal Display Window visible. 
Example: 

(Make sure the Terminal Display Window is visible) 
SCREEN ON 
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SETCOST NUM EXP 

Description: This command is analogous to the Set Billing Cost choice 
under the Service menu. NUM EXP is the amount to increment the 
billing clock each minute in 100ths of a cent. 

Example: 

(Set billing cost to $5.00/hour) 

SETCOST 833 
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SLOW ON OR OFF EXP 

Description: This command is analogous to the "Timeout after 'X' 
seconds" option in the dialog box brought up by choosing XMODEM And 
Kermit Preferences under the Customize menu. A "SLOW ON" command 
sets the timeout value to 20 seconds. A "SLOW OFF" command sets the 
timeout value to 5 seconds. 

Example: 

(Set XMODEM timeout to 5 seconds) 

SLOW OFF 


STRIP ON OR OFF EXP 

Description: This command is analogous to the "Strip control 
characters from received files" option in the dialog box brought up 
by choosing TEXT File Transfer Preferences from under the 
Customize menu. A "STRIP ON" command checkmarks this option, and a 
"STRIP OFF" command uncheckmarks this option. 

Example: 

(Strip control characters from received text files) 

STRIP ON 
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TTY 
VT52 


VT100 

Description: These three commands tell Red Ryder what kind of terminal 
it is to emulate, a TTY (generic) terminal, a DEC VT52 terminal, or a 
DEC VT100 terminal. 

Example: 
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(Emulate a 80 column VT52 terminal) 
DISPLAY 80 
vT52 


Description: This command is equivalent to choosing VT100 Status Bar 
from under the Local menu. 

Example: 

(Display the VT100 Status Bar) 


XKSTRIP ON OR OFF EXP 

Description: This command is analogous to the "Strip linefeeds from 
received non-MacBinary format TEXT files" option in the dialog 
box brought up by choosing XMODEM And Kermit Preferences from under 
the Customize menu. An "XKSTRIP ON" command checkmarks this option, 
and an "XKSTRIP OFF" command uncheckmarks this option. 

Example: 

(Strip linefeeds from XMODEM received TEXT files) 

XKSTRIP ON 


Procedure Execution Modifiers 


ATTACH FILETYPE EXP,STR EXP 

Description: This command is used in conjunction with the "RUN" command 
in order to launch a Macintosh appication specifying a document for that 
application to open once it has begun execution. For instance, if you 
wanted to leave Red Ryder and run a BASIC program, you would use the 
"ATTACH" command to specify the name of the BASIC program, and then the 
"RON" command to execute the BASIC interpreter application. Or, you 
could use it to cause a spreadsheet program to execute and automatically 
open up a desired spreadsheet data file. 


This command is provided for use by those with above average Macintosh 
experience, as it requires that you know the filetype, as well as the 
file name of the document you wish to attach to the application about to 
be executed. FILETYPE EXP is a four character Finder filetype, and 
STR_EXP holds the file name of the document to be attached. 

Example: 

(I want to start up MacWrite and have it open a MacWrite file) 

(named "Diary". I happen to know that MacWrite documents have a) 
(filetype of "MACA" Both MacWrite and the document reside on a disk) 
(named "MYDISK") 
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ATTACH MACA, MYDISK:Diary 
RON MYDISK:MacWrite 
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DO STR EXP 

Description: This command causes the current Procedure Flle to stop 
execution, and the Procedure File contained in STR EXP to be executed. 
Example: 

(Chain off to the Procedure File "Second Proc" on the disk "MYDISK") 
DO MYDISK:Second Proc 


CRAWL ON OR OFF EXP 

Description: Because Red Ryder uses a compiler, the speed at which a 
Procedure File executes may make the command tracing feature activated 
by the Monitor Procedure command under the Service menu (and the 
"LOUD" Procedure command) useless for keeping track of what's happening 
at any given moment. A “CRAWL ON" command slows down the execution of 
the Procedure File to a rate of one command executed every two seconds. 
A “CRAWL OFF" command makes the Procedure File execute at its normal 
speed. The delay caused by a "CRAWL ON" command is always cancelled 
when the Procedure File is terminated, so that future Procedure Files 
are not affected by it. 

Example: 

(Yikes! Things are running much to fast for me to see, slow it down!) 
CRAWL ON 


Description: The "END" command terminates the execution of a Procedure. 
While Red Ryder will always terminate the Procedure after it has 
executed the last physical Procedure command in a Procedure File 
(whether or not that command is an "END" command), the "END" command is 
useful to terminate the Procedure File at some other place than at the 
physical end of the File. 

Example: 

(If the Yes/No flag is set to "YES", branch to the routine GETMAIL) 
(Otherwise, end the Procedure File immediately) 

IF YES JUMPTO GETMAIL 

END 

:GETMAIL | 

(If I get here, collect my waiting mail) 


Red Ryder Documentation Page 111 


GOSUB LABEL 

Description: The "GOSUB" command is used with small collections of 
commands (called subroutines) that are used by various routines in a 
Procedure. When this command is executed, an immediate branch to LABEL 
is performed, where commands are executed in order until the next 
"RETURN" command. At that point, execution is branched back to the 
command following the original "GOSUB" command.  Subroutines may 
"GOSUB" to other subroutines to a level of twenty deep, with subsequent 
"RETURN" commands returning to the command following the most recently 
executed "GOSUB" command. 

Example: 

(This routine will branch execution to the subroutine FIRST) 

(FIRST will ring the bell once and branch to the subroutine SECOND) 
(SECOND will ring the bell once and return back to FIRST. FIRST then) 
(rings the bell once more, and then returns back to the command) 
(following the original GOSUB command, which halts execution of the) 
(Procedure.) 

GOSUB FIRST 

END 

¡FIRST 

BELL 

GOSUB SECOND 

RETURN 

: SECOND 

BELL 

RETURN 


HOST 

Description: The "HOST" command terminates execution of the Procedure 
File and puts Red Ryder in "Host Mode", which is equivalent to choosing 
Cancel Procedure from under the File menu, and then choosing Host 
Mode from under the Local menu. The Host Mode command "DO" may be 
used to exit the Host Mode and execute a Procedure File. 

Example: 

(Quit the Procedure File here, and immediately go into Host Mode) 

HOST 
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IF ERROR PROC CMD 

Description: If the Error flag is set to "ERROR", the Procedure Command 
PROC CMD is executed. If the Error flag is set to "NO ERROR", the 
Procedure Command PROC_CMD is not executed. 

Example: 

(If there's an error, ring the bell and quit the Procedure) 

IF ERROR GOSUB ERROR ROUTINE 
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(Otherwise, just end the Procedure here) 
END 

:ERROR ROUTINE 

BELL 

RETURN 
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IF NO ERROR PROC CMD 

Description: If the Error flag is set to "NO ERROR", the Procedure 
Command PROC CMD is executed. If the Error flag is set to "ERROR", the 
Procedure Command PROC CMD is not executed. 

Example: 

(If the Error flag is set to "NO ERROR" end the Procedure, otherwise) 
(ring the bell once and then end the Procedure) 

IF NO ERROR END 

BELL 

END 


IF NO PROC CMD 
Description: If the Yes/No flag is set to "NO", the Procedure Command 
PROC CMD is executed. If the Yes/No flag is set to "YES", the Procedure 
Command PROC CMD is not executed. 

Example 

(If the numeric variable A$ is not less than 15, ring the bell) 

TEST A%<15 | | 

IF NO BELL 


IF YES PROC CMD 

Description: If the Yes/No flag is set to "YES", the Procedure Command 
PROC CMD is executed. If the Yes/No flag is set to "NO", the Procedure 
Command PROC CMD is not executed. 

Example 

(If the numeric variable A% is less than 15, ring the bell) 

TEST A%<15 

IF YES BELL 
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JUMPTO LABEL 

Description: The "JUMPTO" command is used to branch immediately to a 
different place in the Procedure File, marked by LABEL. 

Example: 

(Branch immediately to the label LABEL1) 
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JUMPTO LABEL1 

(The following BELL command will never be executed!) 
BELL 

: LABEL1 

(Ring the bell once and end the Procedure File} 
BELL | 

END 


LOCK ON OR OFF EXP 
Description: The "LOCK" command is included for very special 
circumstances, and should not be used indiscriminantly. The normal 
policy of execution is for Red Ryder to perform one Procedure 
instruction, look for and process any incoming data over the serial port 
or handle user input, execute the next Procedure command, process 
incoming data and handle user input, and so forth. A "LOCK ON" command 
places the Procedure file in a closed loop, where Procedure commands 
will be executed continously without interruption until a "LOCK OFF" 
command is executed, which puts Red Ryder back into a normal mode of 
operation. 


Be yery careful with this command, because incoming data, menu 
selections, keyboard presses, mouse activity, etc. are completely locked 
out. If your Procedure goes into an endless loop, the Macintosh would 
actually have to be turned off and then back on in order to regain 
control. It is most useful when you have a small number of commands 
that must be executed in a burst before any waiting incoming data is 
collected and processed. 

Example: 

(Look for the string of characters "CONNECT" to come over the) 

(serial port) 

PROMPT CONNECT 

(Now open up the file MYDATA on the disk MYDISK, and then look for the) 
string "PASSWORD?" to come over the modem. If the string came and went) 
before the OPEN command was finished, I would miss it completely, so) 
(let's put the Procedure in a locked condition during the open and use) 
(an ALERT command to do the looking) 

ALERT1 PASSWORD?/JUMPTO GOT IT 

LOCK ON 

USEROPENI 1,MYDISK:MYDATA 

(OK, open the floodgate, if the string was received during the) 
(USEROPENI command, the active ALERT command will see it) 

LOCK OFF 

(If we got here, the string was not in the waiting data, so we'll just) 
(use a normal PROMPT command to look for the string) 

PROMPT PASSWORD? 

(In either case, we ought to get to here when "PASSWORD?" is received) 
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:GOT IT 

(Just ring the bell and end the Procedure here) 
BELL 

END 


ONPANIC PROC CMD 

Description: This command places the Procedure Command PROC_CMD in a 
temporary holding space, if the "PANIC" condition occurs while a 
"PROMPT" or "ALERT" command is active, PROC CMD is retrieved and 
immediately executed. The "PANICAFTER" command is used to describe 
when the "PANIC" condition exists. 

Example: 

. (If the string "CONNECT" does not come over the serial port in 30) 
(seconds, set the "PANIC" condition and log off immediately) 
PANICAFTER 30 

ONPANIC JUMPTO GET OUT 

PROMPT CONNECT 

(If we get here, everything went fine, we'll just end the Procedure) 
(File here, though) 

END 

:GET OUT 

(Gadzooks! If we got here the "CONNECT" string didn't arrive, so we) 
(would follow these comments with a routine to hang up the phone.) 
TYPE +++ | 

PROMPT OK 

PAUSE 

TYPE ATH^M 

END 


PANICAFTER NUM EXP 

Description: This command is used in conjunction with the "ONPANIC" 
command to specify how long to wait for a desired string of characters 
to arrive before giving up and setting a "PANIC" condition. NUM EXP is 
the number of seconds to wait once a "PROMPT" or "ALERT" command is 
executed before executing the Procedure Command specified in the most 
recent "ONPANIC" command. Whenever a "PROMPT" or "ALERT" command is 
satisfied by an incoming string, the "ONPANIC" command is cancelled 
and must be followed by another "ONPANIC" command if desired to work 
for subsequent "PROMPT" or "ALERT" commands. | 


Example: 
(Wait 30 seconds for "CONNECT", branch to "GET OUT" if it doesn't come) 
ONPANIC JUMPTO GET OUT ` 


PANICAFTER 30 
PROMPT CONNECT 
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(Type a CTRL-C, then wait for the string "PASSWORD?") 

PAUSE 

TYPE °C 

(The PANICAFTER command was turned off if I got here, so I need to do) 
(another one) 

PANICAFTER 30 

PROMPT PASSWORD? 

(Everything worked fine, so type my password and end the Procedure) 
PAUSE 

TYPE MyPassword”M 

END 

:GET OUT 

(Whoops, one of the PROMPT's never arrived, so I'll hang up the phone) 
(and alert the user with a couple of bells.) 

TYPE +++ 

PROMPT OK 

TYPE ATH^M 

BELL 

BELL 

END 


PAUSE [NUM EXP] 

Description: This command stops execution of the Procedure File for a 
specified period of time, and then allows the Procedure File to continue 
execution as normal. NUM EXP is a number of 1/60ths of a second to 
delay. If you wished to pause the Procedure for one second, you would 
use a "PAUSE 60" command, for three seconds "PAUSE 360". NUM EXP is 
optional - if it isn't supplied, a value of 60 (one second) is used. 
Example: 

(Wait of the string "CONNECT" to come over the modem) 

PROMPT CONNECT 

(Always pause for a second before typing something to make sure the) 
(remote machine is ready to handle your input. The following command) 
(will pause for 1 second) 

PAUSE 

(Now, type in my secret password and a carriage return) 

TYPE MyPassword^M 
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QUIT 

Description: This command causes the Procedure File to immediately 
terminate execution, and then it will cause Red Ryder to immediately 
terminate execution (equivalent to choosing Quit from under the File 
menu) and return to the Finder. 

Example: 

(I'm all done with Red Ryder, quit back to the Finder) 
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RETURN 

Description: This command is used in conjunction with the "GOSUB" 
command to end execution of a subroutine and branch back to the 
Procedure command following the most recently executed "GOSUB" command. 
Example: 

(Ring the bell five times) 

GOSUB RINGS 

(Ring it five more times) 

GOSUB RINGS 

(What the hell, ring it five more times) 

GOSUB RINGS 

(And end the procedure) 

END 

:RING5 

BELL 

BELL 

BELL 

BELL 

BELL 

(Enough ringy-dingy's, return back to the GOSUB that called "RING5") 
RETURN | 


RUN STR EXP 

Description: This command is used to transfer from Red Ryder to a second 
Macintosh application, bypassing the Finder. STR_EXP is the filename of 
the application to execute. If filename is wrong or doesn't exist, an 
error message is generated to the user and the Procedure File is 
terminated, but Red Ryder is not terminated. WARNING: The "RUN" 
command is not guaranteed to work properly in all Macintosh 
environments, such as those running under a file sharing or multitasking 
system. 

Example: 

(Here's a handy little Procedure I use to branch directly to another) 
(Macintosh application. It first restricts the GETFILE command to) 
(files of only type "APPL", which is the filetype of all Macintosh) 
(applications, has the user select the file, and the executes it.) 
GETSELECT APPL | 
GETFILE AS 

(Make sure he didn't click the Cancel button) 

IF NO END 

IF YES RUN A$ 
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WAIT STR EXP 

Description: The "WAIT" command is used to temporarily stop execution 
of a Procedure File until a certain time of day. STR_EXP is the time of 
day to wait until in 24 hour format (10:00:00 PM would be given as 
22:00:00). The time must be in the form: 

HH:MM:SS 

where: 

HH = hours (00 to 24) 

MM = minutes (00 to 59) 

SS = seconds (00 to 59) 

leading zeros are necessary for values less than 10. The string: 
5:30:8 

must be supplied with leading zeros, as in: 

05:30:08 

to function correctly. When the specified time is reached, execution 
resumes normally with the command following the "WAIT" command. 
Example: 

(Wait until 10:30 PM) 

WAIT 22:30:00 

(And ring a bell) 

BELL 


User Defined Menus 


Red Ryder gives you the opportunity to create your own customized pull 
down menu that can be used to either send a string of characters or 
execute a Procedure File. You have complete control of how your menu is 
named and it's contents, and your menu can contain up to 20 menu 
choices. Here is an example Procedure File that will create a menu 
called "Scott" which has five choices. The first four choices will just 
send a string telling us which menu choice sent it. The last menu 
choice will execute a Procedure File named "PROCFILE" which is on a disk 
named "HD20". 


(Make sure there aren't any user defined menus left around by some) 
{other Procedure File) 

MENUOFF 

(Create a menu called "Scott" in Memory) 
DEFINE MENU Scott 

(Add the five menu choices I want in order) 
ADD TO MENU This is menu choice #1 

ADD TO MENU This is menu choice #2 

ADD TO MENU This is menu choice #3 

ADD TO MENU This is menu choice #4 

ADD TO MENU This is menu choice #5 
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(Tell Red Ryder what each macro key is supposed to do) 
MENUDOES 1,I just chose menu choice #1°M 

MENUDOES 2,I just chose menu choice $2^M 

MENUDOES 3,I just chose menu choice #3°M 

MENUDOES 4,I just chose menu choice #4°M 

MENUDOES 5, \HD20:PROCFILE 

(Show the menu in the menu bar) 

INSERT MENU 

END 


ADD TO MENU STR EXP 

Description: This adds a menu choice to the menu you've defined. The 
new choice is added to the end of any existing commands. There is no way 
to insert a command before others or delete individual commands, SO 
choose the order of your menu choices with forethought. STR EXP 
contains the text that will appear in the menu choice with one notable 
exception. Certain special characters in STR EXP are used to affect the 
appearance of the menu choice, so be careful about using non- 
alphanumeric characters in STR EXP. 


W 

users only. You will probably never use hardly any of the following 
information (except maybe the dividing line thingy), and some of it is 
pretty obtuse, but I'll document it here so you can play with it and 
show people all kinds of “betcha didn't know" magic later. 


The three characters * ! and / should never be used in menu choice 
strings. Trust me on that. The three characters < ( and - do have 
special functions which are of some use. Here's what they do: 
Character Function 
< The menu item has a special character style. The style 
to use is designated by the character following the * 
character and is one of the following: 


<B ~ boldfaced 
<I - italicized 
<U - underlined 
«o - outlined 
«S - shadowed 


I don't know that there's any reason more than one style 
couldn't be used, but let's keep this thing under control, 
eh? 

- Menu is filled with a line of hyphen characters. This 
should always be used with the ( character so that the 
choice is not selectable by the user. 

( Choice is disabled. Many Mac menus have a dividing line of 
disabled hypen characters. To put one of those in your 
menu, you would use the special command: 

ADD TO MENU (- 
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As another example, the command: 

ADD TO MENU This is a choice«O«U 

Would make the words "This is a choice" appear as both 
outlined and shadowed in the menu. 


DEFINE MENU STR EXP 

Description: This gives your menu a name. I highly recommend you do a 
"MENUOFF" command before executing this command to be sure any 
previously defined menu is disposed of before the new one is defined. 
Note that this just creates the menu in memory - it does not display the 
menu in the menu bar. Once you've executed this command, you'll do some 
"ADD TO MENU" and "MENUDOES" commands to define the contents, 
appearance, and functions of the menu choices, and then execute an 
"ENABLE MENU" command to display the menu in the menubar and make it 
choosable by the user. STR EXP holds the menu's title that will appear 
in the menu bar when the menu is enabled, and it may not be more than 20 
characters long. 


DISABLE MENU NUM EXP 

Description: This command can be used to disable (make gray and 
unselectable) any menu item (if NUM EXP is from 1 to 20) or the entire 
menu if NUM EXP is zero. 

Example: 

(Disable the third choice in my menu) 

DISABLE MENU 3 


ENABLE MENU NUM EXP 

Description: After any DISABLE MENU command, this command can be used to 
enable any menu item (if NUM EXP is from 1 to 20) or the entire menu if 
NUM EXP is zero. 

Example: 

(Re-enable the third choice in my menu) 

ENABLE MENU 3 


INSERT MENU 
Description: This command is done after all of the menu items have been 
added to the menu, it simply draws the menu in the menu bar in an 
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enabled state. 
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MENUDOES NUM EXP,STR EXP 

Description: This command defines exactly what your menu choices do 
when they are selected. NUM EXP is a number from 1 to 20 that 
corresponds to a menu choice (1 being the topmost menu choice and 20 
being the bottommost menu choice). If the first character of STR_EXP is 
a backslash (\), the rest of STR_EXP is considered to be a filename of a 
Procedure File to execute immediately. If the first character is not a 
backslash, STR_EXP it is considered to be a string of characters to send 
through the serial port immediately. In other words, STR_EXP 
corresponds exactly to what you would put into a Macro Key string 
(including special and control characters). STR_EXP may not exceed 40 
characters. 


MENUOFF 

Description: This disables the defined menu, removes it from the menu 
bar, and wipes it out of memory. If there is no defined menu, this 
command does nothing. User-defined menus are not removed or disabled 
when a Procedure terminates - they stay on the menubar until a 
"MENUOFF" command is executed. Therefore, it's a real good idea to 
put a "MENUOFF" command before any "DEFINE MENU" commands to wipe out 
any old user-defined menus left behind by other Procedure Files. 
Example: | 

(Get rid of my user defined menu) 

MENUOFF 


User Defined Dialog Box Commands 


Red Ryder's Procedure language allows you to use one of five 
preprogrammed dialog boxes for displaying information and collecting 
information from the user. Each of the five different dialog boxes has a 
different appearance, and is useful in a specific kind of user 
notification or input request. 


QUERY1 STR VAR 


Description: The dialoq box brought up by this command contains three 
lines of prompting text, one editable text item, and an "OK" button. On 
entry, you should pass the three lines of text to prompt the user with 
in the string variables X$, Y$, and 2$ (from top to bottom). On exit, 
STR VAR will contain the text the user typed into the editable text 
item. 

Example: 
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(Put my prompting message in X$, YS, and Z$) 

COPYINTO X$,Please type the name of your favorite music group, 
COPYINTO YS,"Hack And Slash" movie, or television evangelist. 
COPYINTO Z$,1f you have no favorite, just click the "OK" button. 
(Bring up the dialog box and get the user's input) 

QUERY1 AS 

(His response is now in A$) 


QUERY2 

Description: The dialog box brought up by this command contains three 
lines of prompting text and an "OK" button. On entry, you should pass 
the three lines of text to prompt the user with in the string variables 
x$, YS, and 2$ (from top to bottom). 

Example: 

(This just tells him what we're about to do, it doesn't get any info) 
(from the user) 

COPYINTO X$,This is going to take me a while. 

COPYINTO Y$,Go grab yourself some dinner, OK? 

(We don't need three lines, so just erase Z$ so it shows up blank) 
ERASE Z5 

(And put up the dialog) 

QUERY2 


QUERY3 


Description: The dialog box brought up by this command contains three 
lines of prompting text, a "Yes" button, and a "No" button. On entry, 
you should pass the three lines of text to prompt the user with in the 
string variables X$, Y$, and 2$ (from top to bottom). On exit, the 
Yes/No flag will be set to "YES" if the user clicked on the "Yes" 
button, or "NO" if the user clicked on the "No" button. 

Example: 

(Ask him if he really, really, etc. wants to do something) 

COPYINTO X$,Do you really, really, really, really, 

COPYINTO Y$,really, really, really, really, really, 

COPYINTO ZS,REALLY, REALLY want to hear the bell? 

(Put up the dialog box) 

QUERY3 

(If he clicked on the "No" button, quit the Procedure) 

IF NO END | 

(Otherwise, we know he clicked on the "Yes" button) 

BELL 
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QUERY4 

Description: The dialog box brought up by this command contains one line 
of prompting text, a "Yes" button, and a "No" button. On entry, you 
should pass the line of text to prompt the user with in the string 
variable X$. On exit, the Yes/No flag will be set to "YES" 1f the user 
clicked on the "Yes" button, or "NO" if the user clicked on the "No" 
button. 

Example: 

(Get a brief confirmation) 

COPYINTO X$,Wanna hear the bell? 

(Put up the dialog box) 

QUERY 4 

(And succumb to the user's command) 

IF YES BELL 


~o 4 am ar s. s s eee eee A A SER 


QUERYS 

Description: The dialog box brought up by this command contains one line 
of prompting text and an "OK" button. On entry, you should pass the 
line of text to prompt the user with in the string variable XS. 

Example: 

(Let the user know that everything is fine) 

COPYINTO x$,The Procedure was successful! 

(Put up the dialog box) 

QUERYS 
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Procedure File Examples 


EXAMPLE #1: 

Description: Shows how the "@ ON", "@ OFF", and "SHOW@" commands are 
used together to display the Special Status Bar. Also used: PROMPT, 
ERASE, and COPYINTO. 


(Load the the three @ variables with our message to display) 
COPYINTO @0,Waiting for the string "CONNECT" to arrive. 
COPYINTO @1,Please be patient! - 
(We only need two lines, so we'll ERASE the third) 

ERASE (2, 

(Turn on the Special Status Bar) 

@ ON 

(And show the contents of the three @ variables) 

SHOWG 

(Now wait for the "CONNECT" string to arrive) 

PROMPT CONNECT 

(And turn off the Special Status Bar) 

@ OFF 


EXAMPLE 42: 

Description: Shows how the "ALERT" and "PROMPT" commands are used 
together to look for two different possible strings to be received, and react by 
branching to the correct routine to handle the one that is received. Also used: 
BELL, END, and JUMPTO. 

(Wait for either "you have mail" or the string "Command?" and branch to) 
(appropriate routine. This allows me to be looking for two things at) 
(once) 

ALERT1 you have mail/JUMPTO HAVEMAIL 

PROMPT Command? 

(I got the "Command?" string so I JUMPTO somewhere else) 

JUMPTO DOCOMMAND | 

: HAVEMATL 

(If I get here, I got the "you have mail" string and need to) 

(insert the commands here to handle that) 

(But for this example, we'll just string ‘em both together) 

: DOCOMMAND 

BELL 

END 


EXAMPLE #3: 

Description: Shows how the "USEROPENO", "USEROPENA", 
"USEROPENI", "USERREAD", "USERWRITE", "USERWRCR'", and 
"USERCLOSE" commands are used to create, read, and write data with disk 
files. The Procedure creates a file, writes two lines of text, closes the file, 
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reopens the file, writes one more line of text, closes the file, reopens the file for 
input, reads the lines of text back in, and finally closes the file again. 
(Create the file for output using path number 1 on a disk) 
(named "MYDISK") 

USEROPENO 1,MYDISK:DATAFILE 

(Write a line of text to the file) 

USERWRITE 1,This is line #1 

(Terminate it with a carriage return) 

USERWRCR 1 

(And do the same thing again for the second line) 
USERWRITE 1,This is line #2 

USERWRCR 1 

(Now close the file) 

USERCLOSE 1 

(Let's reopen it now for append) 

USEROPENA 1,MYDISK:DATAFILE 

(And write one more line of text to it) 

USERWRITE 1,This is line #3 

USERWRCR 1 

(And close it up again) 

USERCLOSE 1 

(OK, Let's open it up for input this time) 
USEROPENI 1,MYDISK:DATAFILE 

(And read the three lines of text into the string) 
(variables A$, BS and C$) 

USERREAD 1,A5 

USERREAD 1,B5 

USERREAD 1,C$ 

(AS now contains "This is line #1") 

(BS now contains "This is line #2") 

(CS now contains "This is line #3") 

(Close up the file to finish things off) 
USERCLOSE 1 


Example #4: 

| want to call Big Bob's BBS using 1200 Baud, NO Parity, 8 Data Bits, 1 Stop Bit, 
and FULL Duplex. The number is (000)555-1212. I'm using a Hayes 
compatible modem. Please note that this is a bogus phone number. 


(Set the serial port settings) 
COMM 1200-N-8-1-FULL 

(Tell the modem to dial the number) 
DIAL ATDT 1 000 555 1212 


Example #5: 
Here's how | log onto CompuServe (using a CIS node - not Telenet!). | have a 
Macro Keys file named CIS MACROS on the disk named MYDISK that | want to 


load in, also. 
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(Set the communications parameters) 

COMM 1200-N-8-1-FULL | 

(Load in my Macro Keys file - you may or may not want to do this) 
MACRO MYDISK:CIS MACROS 

(Now dial my local access number) 

DIAL ATDT 555-1212 

(Wait for the last part of the message CONNECT from the modem) 
PROMPT NECT 

(reset my elapsed time and billing clocks so I know how long) 
(I've been on and how much I've spent) 

RESET : 

(hang loose a second for the connection to get established solidly) 
PAUSE 

(need to send them a CONTROL-C to get started) 


TYPE ^C 

(CompuServe asks me for "User ID:") 

PROMPT ID 

(Always use a PAUSE after a PROMPT!) 

PAUSE | 


(Type in my user ID with a carriage return at the end) 
TYPE 73176,61^M 

(Now CIS asks me "Password:") 

PROMPT word 

(Give the line a chance to settle down) 

PAUSE 

(I type in my password now, followed by a carriage return) 
TYPE MY/SECRET^M 

(The ! character is what CIS uses for a command prompt) 
PROMPT ! 

(Getting the hang of this PROMPT/PAUSE routine, now?) 
PAUSE 

(Onward to MAUG's MAC USER forum!) 

TYPE GO MACUS^M 

(Hey human, ol' Red did all the work! Wake up! Wake up!) 
BELL 

BELL 

BELL 

BELL 


Example #6: 

I've just downloaded a neat public domain program called Space Potatoes, put 
it on a disk called GAMES and three of my buddies want a copy. I just instuct my 
modem to answer the phone (using the "ATSO=1" modem command), tell them 
to give me a call, type in the secret password GOOBER, and my Mac will send 
the file XMODEM. I'm going to put this Procedure on that same disk and call it 
BUDDIES PROCEDURE. Of course, while one guy's online, the other two have 
their Red Ryder's set up for redialing.... Remember that in order for this to 
work, all of your buddies have to call in using 1200-N-8-1-FULL 
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parameters. 


(Set up the serial port settings) 

COMM 1200-N-8-1-FULL 

(I can ignore everything else until my secret password comes in!) 
PROMPT GOOBER 

(Tell 'em what we're about to do - notice the leading carriage) 

(return to get past the password they typed and make things look clean) 
TYPE ^MStarting XMODEM transfer^M 

(Send that file, Red!) 

SENDX GAMES:SPACE POTATOES 


(Start this procedure over again for whoever's left.) 
DO GAMES:BUDDIES PROCEDURE 


Example #7: 
Here's my super-simple "Hang Up The Phone" procedure that | like to link 
through a Macro Key. Works only with Hayes and compatible modems. 


(Type the modem escape sequence - NO CARRIAGE RETURN HERE!) 

TYPE +++ 

(Modem will go into command state and return "OK" message) 

PROMPT OK 

(So I now pause a moment and type the modem hang up command with a) 
(carriage return) 

PAUSE 

TYPE ATH^M 

(Modem responds again with "OK" and disconnects phone) 


Example #8: 

| like to selectively turn on and off the capturing of certain information to my disk 
for later archiving and perusal. By taking advantage of the fact that the "RECA" 
Procedure command does not destroy a file if it exists (like the Capture 
Incoming Data To TEXT File command under the File menu) but appends 
the new data to the end of the existing file, | can easily come up with a "Capture 
On/Capture Off" pair of Procedure Files that can be linked into Macro Keys for 
one-click operation. | want the capture file to be named "Stored Data" on the 
disk named "Data Disk" and the following Procedures will be on the disk named 
"Red Ryder" 


1) Create and compile the following procedure and save it on the disk 
"Red Ryder" with the name "Capture On". | 


QUIET 
RECA Data Disk:Stored Data 


2) Create and compile the following procedure and save it on the disk 
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"Red Ryder" with the name "Capture Oft". 


QUIET 
CLOSE 


3) Put the following string into Set #1, Macro Key $8 


\Red Ryder:Capture On 


4) Put the following string into Set #1, Macro Key #9 
\Red Ryder:Capture Off 


Give those two Macro Keys appropriate labels, while you're at It; 
("Capture On" and "Capture Off: would be just fine). 


Now, whenever you select Macro Key #8 from Set #1, incoming data will be 
directed to the file "Stored Data" on the disk "Data Disk". Select 
Macro Key #9 from Set #1 to turn off this saving of incoming data. When 
you have the Macros Status Bar on the screen, you can turn the capturing 
on and off with a click of your mouse! 


Example #9: 

| want to use the Host Mode on my office computer when | get home from work, 
but ! don't want anyone else being able to get in except me. The following 
Procedure waits for the secret password "GAZORK" before letting me into the 
Host Mode. I'm going to name this Procedure "Password" on the disk 
"MYDISK". Note: remember to set your modem to auto-answer the phone by 
using the modem command “ATSO=1". 


(The following message won't be seen when you start up this Procedure) 
(the first time - it's just there to let you know that the Procedure) 
(is running again when you later exit the Host Mode) 

TYPE Password protect installed. Hang up now...^M 

(The modem should already be in auto-answer mode, so we'll just wait) 
(for our magic password to come in and ignore everything else) 

PROMPT GAZORK 

(Caller is now let in. Tell them what we're about to do and what to do) 
(before disconnecting) 

TYPE Now going to Host Mode. Type in the command^M 

TYPE "DO MYDISK:Password" when you're done^M 

(And now quit the Procedure and enter the Host Mode) 

HOST 


Example #10: 

Redialing one service is fine, but let's get real clever and redial 4 services (or 
more if you wanted) in a daisy-chain fashion. When you get connected, Red 
rings like crazy till you choose Cancel Procedure from under the Service 
menu. This procedure assumes that the communications parameters are the 
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same for all four services, and have been set before this Procedure is executed. 
The two ALERT commands are used to trap the modem's "NO CARRIER" and 
"BUSY" messages, and the PROMPT is used to trap the "CONNECT" 
message. Suggestion: you could dress this up by inserting the name of the 
service you are currently dialing into a string variable, and then use the 
CONCAT command to attach the name of the connected service to the 
displayed message. 


:FIRST 

DIAL ATDT 555-1111 

ALERT1 CARR/JUMPTO SECOND 

ALERT2 BUSY/JUMPTO SECOND 

PROMPT NECT 

JUMPTO ONLINE! 

: SECOND 

PAUSE 

DIAL ATDT 555-2222 

ALERT1 CARR/JUMPTO THIRD 

ALERT2 BUSY/JUMPTO THIRD 

PROMPT NECT 

JUMPTO ONLINE! 

: THIRD 

PAUSE 

DIAL ATDT 555-3333 

ALERTÍ CARR/JUMPTO FOURTH 

ALERT2 BUSY/JUMPTO FOURTH 

PROMPT NECT 

JUMPTO ONLINE! 

PAUSE 

: FOURTH 

PAUSE 

DIAL ATDT 555-4444 

ALERT1 CARR/JUMPTO FIRST 

ALERT2 BUSY/JUMPTO FIRST 

PROMPT NECT 

: ONLINE! 

COPYINTO @0,Connected to remote service! 
COPYINTO @1,Please select "Cancel Procedure" from under the Service 
COPYINTO @2,menu to go online. 
Q ON 
SHOWS 
: LOOP 
BELL 
PAUSE 
JUMPTO LOOP 


Example #11: 
When you change your communications parameters, your Hayes compatible 
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modem may or may not be ready to immediately respond to further commands. 
What you need to do first is get the modem to recognize your new parameters 
by typing the "attention" modem command "AT" a few times until your modem 
responds with the message "OK". The following routine should be used after 
any COMM command. 


(Set new serial port settings) 

COMM 1200-N-8-1-FULL 

(Send "AT" command and carriage return to get modem's attention) 
TYPE AT^M 

PAUSE 

(Send it again to make sure it's all set) 

TYPE AT^M 

PAUSE 

(Yes Virginia, we are going on blind faith that the "OK" really came) 
(back from the modem, but I've never had this fail me) 

(If you're REALLY paranoid, you could use ONPANIC and PANICAFTER) 
(comnands with a PROMPT OK to be sure that the "OK" actually came back) 
DIAL 555-1212 

(Rest of Procedure goes here) 


Example #12: 

The following code fragment can be added to the beginning of a Procedure File 
to make sure that only those who know the password (in this case, the word 
"SECRET") can execute it. If the Procedure is compiled with encryption, a 
routine like this can make the file impervious to compromise. 


(Present a dialog box asking for a password) 

COPYINTO XS,This procedure is limited to authorized users 
ERASE Y$ 

COPYINTO 2$,Please type in your password 

QUERY1 AS 

(See if the user actually typed something) 

EMPTY AS 

IF YES JUMPTO ABORT 

(Convert what he typed to all uppercase) 

CONVUP AS 

(See if it contains the password "SECRET") 

CONTAINS SECRET 

IF NO JUMPTO ABORT 

JUMPTO CONTINUE 

‚ABORT 

(This is what happens if he fails to type the correct password) 
END 

: CONTINUE 

(Rest of Procedure begins here) 
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Letting Red Ryder Write A 
Procedure File For You 


The Write A Procedure For Me menu command under the Service menu 
can be used to write Auto-logon Procedures, Procedures to be used while 
inside a service, or even full session unattended Procedures. It basically 
monitors incoming and outgoing data and generates the proper Procedure 
commands to navigate in a mirror image fashion of your actions. Of course, this 
presumes that the host will react ina consistent manner from session to 
session. If it doesn't, a small amount of fine tuning may be necessary. 


After selecting the Write A Procedure For Me command, you will be 
orompted to enter the resulting filename for the Procedure. It'll be saved as a 
TEXT file of Procedure command source code that you'll later need to compile. 
After specifying the name, you'll be asked whether or not you wish the 
Procedure to begin by intializing the system to ail current terminal settings. If 
you answer affirmatively, all of the Procedure commands (such as COMM, 
SLOW ON, CONTROL1, etc) applying to settings parameters will be generated. 
It will also include a short sequence for initializing a Hayes compatible modem: 


TYPE AT^M 
PAUSE 
TYPE AT^M 
PAUSE 
TYPE AT^M 
PAUSE 


This matches baud rates and prepares the modem for a dialing command (you 
can edit out this sequence or modify it appropriately if you don't have a Hayes 
compatible modem). You should answer Yes to this prompt only if your 
Procedure will begin by dialing a service. For procedures that will be executed 
while already inside of a service, you would not want ail of the initialization stuff 
to occur. 


For this reason, you must have all settings the way'you want them before you 
choose the Write A Procedure For Me command. Once the Procedure 
generation has begun, clicking on the baud rate (for instance) parameter will 
not be recorded in the Procedure file. Some menu command selections are 
supported during Procedure generation, they're listed below. 


A good number of people (like me) have gotten into the shortcut habit of just 
typing the modem dialing command, rather than by using the Dial Or Redial 
A Number menu command. This habit must be broken for use with the Write 
A Procedure For Me command. It is absolutely essential that you use the 
Dial Or Redial A Number menu command for dialing a service when 
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generating a Procedure, or the resulting Procedure will most likely not work 
properly. 


The Write A Procedure For Me command saves uninterrupted typing 
sequences, and then generates TYPE Procedure commands for the sequence 
when it's interrupted. A typing sequence is interrupted by a carriage return, 
either incoming from the host, or outgoing from the keyboard. If it's outgoing 
from the keyboard the letters ^M are appended to the end of the TYPE 
command to show that you typed a RETURN. When it's interrupted, Red Ryder 
looks at the line you were typing on to determine whether you were typing in 
response to a prompt from the host. If your typing began on the first column of 
the line, no PROMPT statement is generated. Otherwise, up to 10 characters 
preceding the first character you typed are used to generate a PROMPT 
command (which is followed by a PAUSE command). 


The following menu command actions will be saved in the Procedure file: 


* Load Macro Keys From Disk 

« File receives 

« Manual closing of an ASCIl file receive. 
* File sends 

¢ Print TEXT File 

* Delete A File 

* Echo Incoming Data To Printer 

* Load Settings From Disk 

* Dial Or Redial A Number 


When you choose one of the above menu command actions, Red Ryder will 
again look at the most recent line received, if the line is empty, the appropriate 
Procedure command for the Menu choice will be placed immediately after the 
last command in the Procedure file. If the line isn't empty, Red Ryder will want 
to know if you did that menu action in response to a prompt from the host. 


Let's look at an example of both methods. Before you used a Dial Or Redial 
A Number menu command, you might want to load in a set of Macro Keys from 
a file. Since you didn't do that menu command in response to any prompt from 
a host (you aren't even connected to a host yet!), you wouldn't want a PROMPT 
command generated before the menu action command. 


However, opening a receive file to capture all new messages probably would 


be in response to a prompt from the host, and you would want such a PROMPT 
generated in the Procedure file. 


Hints And Tips 


1) The Write A Procedure For Me menu choice turns into Stop Creating 
The Procedure while Procedure generation is active. Choose it to finish 
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generating the Procedure file. 


2) While generating a Procedure file, type slowly and deliberately. Typing 
errors, backspacing, etc. will be repeated verbatim for the next billion years (or 
however long you continue to use that Procedure). 


3) When a menu command and typing action are to take place after the same 
prompt from the host (like opening a receive file and then typing the command 
to list all new messages), choose the menu action first if possible (so that the 
PROMPT command will be placed before the menu action command, followed 
immediately by the typing sequence). A typing sequence must never be 
interrupted by a menu command action - do one before or after the other only. 
However, if you're going to be sending or receiving a file using Kermit or 
XMODEM, you'll find that the keyboard is locked out after the menu command is 
executed, so in this case the typing sequence would come first, followed by the 
menu action. 


4) The logic for this command was derived by observation, and there's always 
room for improvement and added utility. Please pass along any comments or 
suggestions to me so | can incorporate them in future versions. 


5) Break signals, Macro Keys, VT100 status bar and numeric Keypad 
sequences, and automatic VT100 cursor key positioning are not supported in 
Procedure generation). Typing sequences are limited to normal ASCII 
alphanumeric and control keys. 


Why Would | Want To Edit Generated Procedure? 


CompuServe is a good example of a inconsistent host. The first menu you may 
see after logging on is unpredictable - it may be either the top level command 
menu or the electronic mail menu if you have messages waiting. On the dark 
side, the prompts for these two menus are quite different, so a generated 
Procedure may get "hung up" because it expects the prompt for a menu that 
never arrives. On the bright side, since both menus use an exclamation point 
("I") as the last character in the prompt, the generated Procedure can be easily 
edited to look for only that character in the first menu PROMPT command if ail 
you wish to do is branch directly to another part of CompuServe. 
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The GETPARAM And PUTPARAM 
Procedure Commands 


RED FLAG NOTE: The information in this chapter is meant only for 
very experienced Red Ryder users! 


The GETPARAM and PUTPARAM Procedure commands allow you to get at 
the "guts" of Red Ryder to perform operations normally not possible through 
other Procedure commands. The GETPARAM and PUTPARAM Procedure 
commands use the following syntax: 


GETPARAM NUM EXP, NUM VAR 
PUTPARAM NUM EXP1,NUM EXP2 


These commands are used to examine or modify one of many internal memory 
parameters used by Red Ryder. These internal parameters are referenced by à 
number which corresponds to their relative offset from the beginning of the 
default Settings File. The GETPARAM command is supplied with the internal 
parameter number in NUM EXP, and the contents of that internal parameter 
(which is always numeric) is placed in the numeric variable designated by 

NUM VAR. In other words, to get the current value in the internal parameter 
#100 and put it into the numeric variable A%, you would use the Procedure 
command: 


GETPARAM 100,A$ 


The PUTPARAM command is used to modify the contents of an internal 
parameter (designated by NUM EXP1) with the contents of NUM EXP2. To 
change the contents of internal parameter #100 to a value of 15, you would use 
the Procedure command: 


PUTPARAM 100,15 


Because the PUTPARAM command modifies things that were never originally 
meant to be diddled by the user (by | have yielded for the benefit of those who 
understand how to handle digital dynamite), it is inherently dangerous. Never 
change an internal parameter not listed below, and modify those only with the 
values designated in the list. Perhaps this warning is making a mountain out of 
a molehill, but the problem is that these internal parameters are saved in 
Settings Files, and a wrong value can therefore propagate to other Settings 
Files without warning. If you plan to distribute Procedures that use the 
PUTPARAM instruction, please give thought to a beginner and display a 
proper warning message to the user before modifications are done (and please 
give him a chance to bail out if he gets scared!). 
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Think of it this way. Using the PUTPARAM command is like using ResEdit on 
a System file. If you understand that and the implications of making a mistake, 
don't be afraid to plunge ahead. 


When there is an equivalent Procedure command, use that in favor of a 
PUTPARAM command, as the equivalent is guaranteed to be safer. For some 
things, like finding out what baud rate or duplex is being used at a given 
moment, there are no equivalent Procedure commands and a GETPARAM 
command must be used. Some operations (like defining the "Enter" key on an 
original Mac 512K keyboard as an Escape key) can only be done with the 
PUTPARAM command. You can use the GETPARAM command on any of 
the internal parameters listed below, but unless a listing below specifically 
states "Use PUTPARAM to modify”, don't use the PUTPARAM command with 
it. By the way, you will find “holes” in the list below. Some internal parameters 
are of absolutely no interest to you, or are reserved for future expansion. 


You'll probably never need any of this stuff. However, | have found a few things 
very useful, and if I've learned anything in the last 9 versions of Red Ryder, it's 
not to second guess your hunger for information and clever ways to use it. The 
following is presented with the forewarning that you need to know Red Ryder 
inside and out to make sense of it, and programming experience (when high 
and low bytes are discussed) may be necessary to use a few of these. 


Parameter #0: Current baud rate. Use COMM command to modify. 
Meaning: 0 = 300, 1 = 450, 2 = 1200, 3 = 2400, 4 = 4800, 
5 = 9600, 6 = 19200, 7 = 57600 


Parameter #1: Current parity. Use COMM command to modify. 
Meaning: 0 = None, 1 = Odd, 2 = Even, 3 = Mark, 4 = Space 


Parameter #2: Current Databits. Use COMM command to modify. 
Meaning: 0 = 7 bits, 1 = 8 bits, 2 = 5 bits, 3 = 6 bits 


Parameter #3: Current stopbits. Use COMM command to modify. 
Meaning: 0 = 1 bit, 1 = 2 bits, 2 = 1.5 bits 


Parameter #4: Current duplex. Use COMM command to modify. 
Meaning: 0 = Full, 1 = Half, 2 = Echo, 3 = Null 


Parameter #6: XMODEM and initial Kermit timeout in seconds. Use 
PUTPARAM to modify. 
Meaning: 1 - 255 (seconds) 


Parameter #7: ASCII char for control button #1 on General Status Bar. 

Parameter #8: ASCII char for control button #2 on general status bar 

Parameter #9: ASCII char for control button #3 on general status bar 
Use CONTROL1, CONTROL2, or CONTROL3 commands to modify. 
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Meaning: (0-255) ASCII value of character button sends. 


Parameter #10: Current number of screen columns. Use DISPLAY command 
to modify. 
Meaning: (20-132) Number of columns 


Parameter $11: Current terminal emulation type. Use TTY, VT52, or 
VT100 commands to modify. 
Meaning: 0 = TTY, 1 = VT100, 2 = VT52 


Parameter #13: Current Status Bar. Use GBAR, BBAR, MBAR, VBAR, 
LOUD, or QUIET commands to modify. 
Meaning: l = General, 2 = Buffered Keyboard, 3 = Macros, 
4 = VT100, 5 = Monitoring procedure 


It 


Parameter #14: Should cursor flash? Use PUTPARAM to modify. 
Meaning: 0 = no flash, 1 = flashing 


Parameter #15: Cursor shape. Use PUTPARAM to modify. 
Meaning: 0 = underline, 1 = block 


Parameter #16: Amount of delay between each character (in 60ths of a 
second) sent with a SENDA Procedure command or Send TEXT File 
menu command if Parameter #27 is nonzero and Parameter #32 = 1. Use 
PUTPARAM to modify. 

Meaning: (0 - 255) number of 60th's of a second to delay. 


Parameter $17: Function of Enter key on original Macintosh 512K (non- 
enhanced and without a built-in numeric keypad) keyboard. Use 
PUTPARAM to modify only if you know that such a keyboard is 
attached. | 

Meaning: 0 = Same as Return key, 1 = ESCAPE key (Parameter 

#98 overrides this) 


Parameter #18: Backspace key mapping. Use DELKEY command to modify. 
Meaning: 0 = backspace (ASCII 8), 1 = DELete (ASCII 127) 


Parameter #19: Active set when macros status bar is showing, or 
when Macro Key is executed from keyboard (using COMMAND-number). Use 
MBAR command to modify. 

Meaning: l, 2, or 3 (active set number) 


Parameters #20 through 23: Four ASCII characters to use as a file type 
(default MACA) for TEXT file or non-MacBinary receives. Use 
PUTPARAM to modify. 

Meaning: Each parameter contains ASCII value of character. 


Parameter #24: Use auto-receive file naming convention? Use PUTPARAM 
to modify. 


Red Ryder Documentation Page 136 


Meaning: 0 = no, get name first, 1 = receive file first, use 
MacBinary name if possible or ask for name then. 


Parameter #25: Send text files as MacBinary? Use PUTPARAM to modify. 
Meaning: 0 = no, 1 = yes 


Parameter #26: Before sending, instruct remote to auto-receive? Use 
PUTPARAM to modify. 
Meaning: 0 = no, 1 = yes 


Parameter 427: Delay after each character or line (depending on 
Parameter 432) sent with a SENDA Procedure command or Send TEXT 
File menu command. Use PUTPARAM to modify. 

Meaning: 0 = no, 1 = yes 


Parameter 428: Should file sent with SENDA Procedure command or Send 
TEXT File menu command be forcefully wrapped at a certain column? 
Use PUTPARAM to modify. 

Meaning: | 0 = no, 1 = yes 


Parameter 429: Column number to wrap line if Parameter #28 is nonzero. 
Use PUTPARAM to modify. 
Meaning: (20-132) column number 


Parameter #32: Kind of delay for SENDA procedure command or Send TEXT 
File menu command if Parameter $27 is nonzero. Use PUTPARAM to 
modify. 

Meaning: 0 = delay between lines sent, 1 = delay between 

characters sent 


Parameter 433: Enable CompuServe 'B' protocol recognition? Use 
PUTPARAM to modify. 
Meaning: 0 = no, 1 = yes 


Parameter 434: Supercharged XMODEM? Use PUTPARAM to modify. 
Meaning: 0 = no, 1 = yes 


Parameter #35: Use 1K blocks for XMODEM? Use PUTPARAM to modify. 
Meaning: 0 = no, 1 = yes 


Parameter 436: Enable RLE graphics recognition? Use PUTPARAM to 
modify. 
Meaning: 0 = no, 1 = yes 


Parameter 437: Scroll lines into saved screens buffer before full screen 


clear? Use PUTPARAM to modify. 
Meaning: 0 = no, 1 = yes 
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Parameter #38: Kermit uses special “Q line turnaround handshake? Use 
PUTPARAM to modify. 
Meaning: 0 = no, 1 = yes 


Parameter #39: Should VTMouse delay? Use PUTPARAM to modify. 

Meaning: 0 = no, 1 = yes 

Parameter #40: Should ` key send the ^ character or the ASCII code in 
Parameter #145? Use ALT command to modify. 

Meaning: 0 = send ` character, 1 = send ASCII code in 

Parameter #145. 

Parameter #41: Should Procedures be monitored in status bar? Use LOUD 
and QUIET commands to modify. 

Meaning: 0 = no, 1 = yes 


Parameter #42: Should date/time heading be printed on the printer? Use 
PUTPARAM to modify. 
Meaning: 0 = no, 1 = yes 


Parameter #43: If Parameter #42 is nonzero, should date/time be printed 
on every page or first page only. Use PUTPARAM to modify. 
Meaning: 0 = every page, 1 = first page only 


Parameter #44: Should printer form feed when the number of lines in 
Parameter #45 has been printed? Use PUTPARAM to modify. 
Meaning: 0 = no, 1 = yes 


Parameter #45: If Parameter #44 is nonzero, do form feed after this 
number of lines. Use PUTPARAM to modify. 
Meaning: (1-255) Number of lines before form feed 


Parameter 446: Wait for character in Parameter $488 after each line sent 
by SENDA procedure command or Send TEXT File menu command? Use 
PUTPARAM to modify. 

Meaning: 0 = no, 1 = yes 


Parameter #48: Is data currently being echoed to the printer? Use ECHO 
command to modify. 
Meaning: 0 = no, 1 = yes 


Parameter #49 

Parameter #50: These two bytes contain the cost(in 100ths of a cent) for 
the billing clock to increment after each elapsed minute. It is a 
two byte integer value, so Parameter $49 holds the high byte value, 
and Parameter #50 holds the low byte value. Use SETCOST to modify. 


Red Ryder Documentation Page 138 


Parameter #60 = Should the following functions include blank lines 
in their output? Use PUTPARAM to modify. 
1) "Archive Display Screen" menu command 
2) "Archive All Screens" menu command 
3) Screen To Disk Button 
4) Screen To Printer Button 
5) SCREENDISK Procedure command. 
6) SCREENPRINT Procedure command. 
Meaning: 0 = yes, 1 = no 


Parameter #61: Should the Delete A File menu choice skip the 
confirming dialog after a file is chosen? Use PUTPARAM to modify. 


Meaning: 0 = no, 1 = yes 


Parameter #62: Should the Delete A File menu choice continually cycle 
through the select and delete process until the user clicks on the 
file selection dialog's "Cancel" button? Use PUTPARAM to modify. 


Meaning: 0 = no, 1 = yes 


Parameter #63: Should the Find Text menu choice use a zooming 
rectangle when the window scrolls? Use PUTPARAM to modify. 
Meaning: 0 = no, 1 = yes 


Parameter #64: Should Macros Status Bar scroll into next (or previous 
set) or just immediately display it when selected by mouse in the 
scroll bar? Use PUTPARAM to modify. | 

Meaning: 0 = scroll, 1 = jump 


Parameter #65: Display title screen on program startup? Use PUTPARAM 


to modify. 
Meaning: 0 = yes, 1 = no 


Parameter #66: Should "Send screen to printer" button on General Status 
Bar confirm with.a dialog box that the user actually wants to do 
that? Use PUTPARAM to modify. 

Meaning: 0 = yes, 1 = no 

Parameter #67: Should "Archive display screen" button on General Status 
Bar confirm with a dialog box that the user actually wants to do 
that? Use PUTPARAM to modify. 

Meaning: 0 = yes, 1 = no 


Parameter #68: Should close box in Terminal Display Window confirm with 
a dialog box that the user actually wants quit? Use PUTPARAM to 
modify. 

Meaning: 0 = yes, 1 = no 


Parameter #69: Should "Reset time and billing clocks" button on General 
Status Bar confirm with a dialog box that the user actually wants 
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to do that? Use PUTPARAM to modify. 
Meaning: 0 = yes, 1 = no 


Parameter #70: If a Procedure File is executed by a macro key while 
another Procedure File is executing, should we put up a dialog 
telling the user to cancel the executing Procedure, or should we 
cancel it automatically and execute the new Procedure? Use 
PUTPARAM to modify. 

Meaning: 0 = dialog, 1 = auto-execute 


Parameter #73: Maximum packet size Red Ryder's Kermit wants (default is 
94). - Use PUTPARAM to modify. 


Meaning: (1 - 94) maximum packet size in bytes. 

Parameter #74: Kermit's start of header character (default is 1). Use 
PUTPARAM to modify. | 

Meaning: (0-255) ASCII code for start of header character. 


Parameter #75: Kermit's definition of SPACE character (default is 32). 
Use PUTPARAM to modify. 
Meaning: (0-255) ASCII code for SPACE character. 


Parameter #76: Kermit's definition of CR character (default is 13). 
Use PUTPARAM to modify. 
Meaning: (0-255) ASCII code for CR character. 


Parameter #77: Kermit's definition of DELETE character (default is 127). 
Use PUTPARAM to modify. 
Meaning: (0-255) ASCII code for DELETE character. 


Parameter #78: Kermit's definition of control character QUOTE character 
(default is 35, a # character). Use PUTPARAM to modify. NOTE: Red 
Ryder will always use the '&' character for 8th bit quoting when 
anything but NO parity is used. 

Meaning: (0-255) ASCII code for QUOTE character. 


Parameter #79: Maximum number of retries Kermit will do before aborting 
a file transfer (default is 5). Use PUTPARAM to modify. 
Meaning: (1 — 255) maximum number of retries 


Parameter #80: Number of padding characters Red Ryder's Kermit wants 
(default is 0). Use PUTPARAM to modify. 
Meaning: (0 - 255) number of padding characters 


Parameter #81: ASCII code of padding character Red Ryder's Kermit wants 


(default is 0). Use PUTPARAM to modify. 
Meaning: (0 - 255) ASCII code of padding character 
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Parameter #82: EOL character Red Ryder's Kermit wants (default is 13). 
Use PUTPARAM to modify. | 
Meaning: (0 - 255) ASCII code of EOL character. 


Parameter #83: Number of seconds Red Ryder's Kermit wants remote Kermit 
to wait before timing out (default is 3). Use PUTPARAM to modify. 
Meaning: (1 - 255) seconds to wait 


Parameter #84: Should TEXT File Transfer Preferences menu choice's 
"Strip Control Characters" option allow tabs to pass through to the 
file in addition to carriage returns? Use PUTPARAM to modify. 

Meaning: 0 = no, 1 = yes 


Parameter #85: Do form feed after printing finishes? Use PUTPARAM to 
modify. 
Meaning: 0 = no, 1 = yes 


Parameter #86: Ignore TTY full-screen clears (ASCII 12)? Use PUTPARAM 
to modify. 
Meaning: 0 = no, 1 = yes 


Parameter #87: Buffered keyboard right margin column. Use PUTPARAM to 
modify. 
Meaning: (1 - 255) right margin column number. 


Parameter #88: Current font number. Use FONT command to modify. 
Meaning: (0 to 255) font number 


Parameter #89: Current font size. Use FONT command to modify. 
Meaning: (1 to 255) font point size 


Parameter #90: High byte of maximum symbol definitions. 
Parameter #91: Low byte of maximum symbol definitions. Use PUTPARAM 
to modify either of these. 


Parameter #92: High byte of maximum symbol references. 
Parameter #93: Low byte of maximum symbol references. Use PUTPARAM to 
modify either of these. 


Parameter #94: Does the compiler encrypt Procedure Files? Use 
PUTPARAM to modify. 
Meaning: 0 = no, 1 = yes 


Parameter #95: Should the high bit (parity bit) be zapped out from 
incoming data? Use NOZAP command to modify. 
Meaning: 0 = zap, 1 = don't zap 


Parameter #96: Show compiler window during compilation? Overridden by 
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COMPILE LOUD and COMPILE QUIET commands. Use PUTPARAM to 
modify. 
Meaning: 0 = no, 1 = yes 


Parameter #97: Should the DTR line be dropped when exiting Red Ryder? 
Use PUTPARAM to modify. 
Meaning: 0 = drop DTR, 1 = don't drop DTR 


Parameter #98: Should the Enter key on the original Macintosh 512K (not 
enhanced with no built-in numeric keypad) keyboard send a linefeed? 
Use PUTPARAM to modify. 

Meaning: 0 = no, 1 = yes 


Parameter #142: Do we have an additional VT100 font? Use PUTPARAM to 
modify. 

Meaning: 0 - no, 1 - yes 

Parameter #143: If Parameter #142 is nonzero, additional VT100 font 
high byte. Use PUTPARAM to modify. 

Parameter #144: If Parameter #142 is nonzero, additional VT100 font low 
byte. Use PUTPARAM to modify. 


Parameter #145: If Parameter #40 is nonzero, this contains the ASCII 
code that that the ` key will send. Use PUTPARAM to modify. 
Meaning: (0 — 255) ASCII code of character to send 


Parameter #146: Override default VT100 special keys mapping and use 
settings installed by "Install Keypad" utility? Use "Install Keypad" 
utility to modify. 

Meaning: 0 = use default, 1 = use installed 


Parameter #488: ASCII character to wait for after each line sent with a 
SENDA Procedure command or Send TEXT File menu command if 
Parameter #46 is nonzero. Use PUTPARAM to modify. 

Meaning: (0 - 255) character to wait for 


Parameter #489: Amount of delay after each line (in seconds) sent with a 
SENDA Procedure command or Send TEXT File menu command if 
Parameter #27 is nonzero and Parameter #32 is zero. Use PUTPARAM 
to modify. | 

Meaning: (1 — 255) delay time in seconds 


Parameter #492: Current serial port in use. Use MODEM and PRINTER 
commands to modify. 
Meaning: | Q = printer, 1 = modem 


Parameter #493: Should the Return key send a carriage return only or a 


carriage return followed with a linefeed? Use LF command to modify. 
Meaning: 0 = carriage return only, 1 = CR/LF 
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Parameter #494: Strip control characters from XMODEM non-Macbinary 
receives? Use XKSTRIP command to modify. 
Meaning: 0 = no, 1 = yes 


Parameter #495: Recognize and use MacBinary for rion-TEXT files? Use 
PUTPARAM to modify. 
Meaning: 0 = no, 1 = yes 


Parameter #503: Use and recognize CRC error checking? Use CRC command 
to modify. 
Meaning: 0 = yes, 1 = no 


Parameter #504: Is a Macintosh Plus keyboard (with built-in numeric 
keypad) currently in use? DO NOT MODIFY! 
Meaning: 0 = no, 1 = yes 


Parameter #505: Redial attempt limit. Use REDIAL LIMIT command to 
modify. 
Meaning: (0 - 255) attempts 


Parameter #506: Strip control characters from RECA Procedure commands 
or Capture Incoming Data To TEXT File menu commands? Use 
STRIP command to modify. 

Meaning: 0 = no, 1 = yes 


Parameter #507: VT100 relative origin mode. Use PUTPARAM to modify. 
Parameter #508: VT100 smooth scroll mode. Use PUTPARAM to modify. 
Meaning: 0 = reset, 1 = set 


Parameter #509: VTMouse waits for host? Use PUTPARAM to modify. 
Meaning: 0 = no, 1 = yes 


Parameter 4585: VT100 Wraparound mode. Use PUTPARAM to modify. 
Parameter 4586: VT100 Autorepeat mode. Use PUTPARAM to modify. 
Parameter #587: VT100 Newline mode. Use PUTPARAM to modify. 
Parameter #588: VT100 Cursor key mode. Use PUTPARAM to modify. 
Parameter #589: VT100 Keypad mode. Use PUTPARAM to modify. 
Meaning: 0 = reset, 1 = set 


Red Ryder Documentation | Page 143 


Index Of Menu Commands 


File Menu 

Capture Incoming Data To TEXT File: 32, 39, 51, 52, 63, 64, 96, 127 
Receive File - XMODEM: 54, 57, 58, 98 
Receive File - Kermit: 58, 97 

Receive Batch - YMODEM: 57, 58, 98 
Send TEXT File: 9, 46, 47, 49, 59, 67, 98 
Send File - XMODEM: 49, 54, 98 

Send File - Kermit: 54, 98 

Send Batch - YMODEM: 57, 98 

Create YMODEM Batch: 57, 98 

Delete A File: 62, 63, 132 

Set Auto-Receive Volume: 57 

Set Archive Volume: 9 

Quit: 6, 116 


Edit Menu 

Undo: 10 

Cut: 22 

Copy: 8 

Paste: 9, 22, 99 

Clear: 10, 22 

Copy Table: 8, 9 

Print Selected Text: 8, 9, 38 
Append To Archive File: 8 
Find Text: 8, 63 

Find Same Text Again: 8 
Edit Control Buttons: 17 
Edit Macro Keys: 25 


Service Menu 

Initiate Procedure: 26, 73 

Write A Procedure For Me: 131, 132 

Compile TEXT File to Procedure: 74 

Check Procedure Syntax: 74 

Dial Or Redial A Number: 40, 44, 45, 84, 108, 131, 132 
Monitor Procedure: 73, 81, 106, 108, 111 

Set Billing Cost: 16, 109 

New Phonebook: 42 

Open Phonebook: 42 


Local Menu 

General Status Bar: 16, 24, 38, 64, 66, 101, 103, 104, 106 
Buffered Keyboard Status Bar: 22, 86 

Macros Status Bar: 24, 25, 63, 64, 73, 76, 91, 107, 128 
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VT100 Status Bar: 22, 28, 35, 37, 110, 133 
Clear Display Screen: 8 

Clear All Screens: 7, 8 

Archive Display Screen: 9, 16 

Archive All Screens: 9, 63 

Print TEXT File: 9, 38, 39, 103, 132 

Echo Incoming Data To Printer: 38, 39, 63, 103, 132 
Tab Stops: 10, 11, 22 

Host Mode: 12, 13, 66, 67, 68, 69, 73, 112, 128 
Bring Other Open Windows To Top: 6 

Hide Terminal Window: 6, 108 

Change Serial Port Settings: 15, 17, 68 

Set Font: 10, 71, 105 


Customize Menu 

XMODEM And Kermit Preferences: 57, 58, 61, 104, 109, 110 
TEXT File Transfer Preferences: 47, 48, 49, 52,60, 64, 109 
Terminal Emulation Preferences: 32, 34, 35, 105 

Keyboard Mapping Preferences: 18, 19, 47, 66, 70, 105, 106 
Printer Preferences: 38 

VT100 Modes: 28, 31, 34, 35, 37, 103 

Personal Preferences: 22, 52, 63, 70, 107 

Procedure Compiler Preferences: 75, 81 

Set Saved Screens Buffer Size: 7 

Load Macro Keys From Disk: 27, 107, 132 

Save Macro Keys To Disk: 27, 107 

Load Settings From Disk: 65, 106 

Save Settings To Disk: 65 
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Index Of Procedure Commands 


@ 83 
ADD 87 ELAPSED 89 
ADD TO MENU 119 EMPTY 89 
ALERT1 83 ENABLE MENU 120 
ALERT2 83 END 111 
ALERT3 83 ERASE 89 
ALT 105 ERASE ALL 89 
AND 87 FASTDUMP 96 
ANSWERBACK 103 FILLS 90 
ATTACH 110 FONT 105 
BBAR 103 GBAR 106 
BELL 84 GETALL 99 
CLEAR 84 GETBOX * (see note below) 
CLOSE 96 GETCOST 91 
COMM 104 3 GETFILE 100 
COMPILE LOUD 99 GETGLOBAL 90 
COMPILE QUIET 99 GETGROUP * (see note below) 
CONCAT 87 GETLINE 85 
CONTAINS 88 GETPARAM 134 
CONTROL1 ^ 104 GETSELECT 99 
CONTROL2 * 104 GOSUB 112 
CONTROL3 * 104 HOST 112 
CONVUP 88 IF ERROR 112 
COPYINTO 88 IF NO 113 
CRAWL 111 IF NO ERROR 113 
epe- adi IF YES 113 
ET INSERT MENU 120 
DELETE 99 acai 

JUMPTO 113 
DELKEY 105 

LF 106 
Dan LEFTS 91 
DISABLE MENU 120 LENGTH 91 
DISPLAY 105 | LET EQUAL 92 
DIVIDE 88 LOADSET 106 
DO 111 LOADVAR 92 
ECHO 103 LOCK 114 
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LONG BREAK 85 
LOUD 106 
MACRO 107 
MBAR 107 
MENUDOES 121 
MENUOFF 121 
MIDS 92 

MODEM 107 
MULTIPLY 92 
NOZAP 107 
NUMTOSTRING 93 
ONPANIC 115 
OR 93 
PANICAFTER 115 
PAUSE 116 
PRINTER 108 
PROMPT 85 
PROMPT ^ 85 
PUTFILE 100 
PUTPARAM 134 
QUERY1 121 
QUERY2 122 
QUERY3 122 
QUERY4 123 
QUERY5 123 
QUIET 108 
QUIT 116 
RECA 97 
RECK 97 
RECX 98 
RECY 98 
REDIAL 84 
REDIAL LIMIT 108 
RENAME 100 
REPLACES 93 
RESET 108 
RETURN 117 
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RIGHTS 93 

RUN 117 
SAVETIME 94 
SAVEVAR 94 
SCREEN 108 
SCREENDISK 101 
SCREENPRINT 103 
SENDA 98 
SENDCLIP 99 
SENDK 98 

SENDX 98 

SENDY 98 
SETCOST 109 
SETGROUP * (see note below) 
SETBOX * (see note below) 
SHELL * (see note below) 
SHORT BREAK 85 
SHOW@ 83 

SLOW 109 
STRINGTONUM 94 
STRIP 109 
SUBTRACT 95 
TEST 95 
TIMEDATE 95 

TTY 109 

TYPE 86 
USERCLOSE 101 
USEROPENA 101 
USEROPENI 101 
USEROPENO 102 
USERREAD 102 
USERWRCR 102 
USERWRITE 102 
VBAR 110 

VT100 109 

VT52 109 

WAIT 118 
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WATCH 86 
WRITE 103 
XKSTRIP 110 


* Note: These commands are 
not documented in this manual 
due to their complexity. 

They are used in conjunction 
with a separate compiler to 
produce a customized 
communications interface. 

The compiler and 
documentation will be 
distributed through the Red 
Ryder Library in the FreeSoft 
RoundTable on GEnie. Those 
who do not have access to 
GEnie may request the 
compiler and documentation by 
sending $10 ($15 outside of 
the United States or Canada). 
Please mention with your 
payment that you wish to 
order the "Shell Compiler" 
and related materials. 
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NZ 


IMPORTANT INFORMATION: YOU MUST READ AND AGREE TO THE ENCLOSED 
SINGLE-COMPUTER END USER SOFTWARE LICENSE AGREEMENT BEFORE ATTEMPTING TO 
USE THE ENCLOSED MASTER DISK. BY USING THE ENCLOSED MASTER DISK, YOU ARE 
AGREEING TO THE TERMS AND CONDITIONS OF THAT DOCUMENT. 


Dear Customer: 


Thank you for your order of Red Ryder 10.3. Please note that the enclosed 
Master disk is NOT a bootable system disk. You must start up your Macintosh 
with a disk containing a System Folder, and then insert the enclosed Master 
disk. Don't do work with the Master, make a backup of it and put the Master 
disk in a safe place in case your backup craps out. 


General Electric has graciously extended a free subscription to their GEnie 
network for all of our customers. This means they waive their normal $18 
signup fee. This is available to all customers in the U-S. and Canada. 
Other customers will receive mail update notices, but U.S. and Canada 
customers should immediately do the following so they can enter the FreeSoft 
RoundTable on GEnie, which is your sole source (except by telephone) for 
future update information. 


1) Using 300 or 1200 baud, NO parity, 8 databits, 1 stopbit, and HALF duplex 
(not FULL!), call the following toll free number: 1 (800) 638-8369 


2) When connected, immediately type 3 'H' characters and press the 
Return key. 


3) After a couple of seconds you'll get a prompt of "U=". You should type: 
XJM11979,FREESOFT and press the Return key. 


4) You'll now be taken on a tour of GEnie and asked to fill in your billing 
information. The "800" number does not give you access to the actual GEnie 
network, but is for subscription purposes only. You can and should check 
out what your local GEnie access number(s) are while doing this procedure. 
Those numbers will be what you'll call after receiving your account to log 


into GEnie. 


5) After supplying your billing information, you'll be contacted voice by 
GEnie within the next week with your new account number and password. After 
you get this, you can log onto GEnie through your local access number. Once 
on, you should type the word "FREESOFT" at any GEnie menu prompt. 


6) You'll be teleported to the FreeSoft RoundTable, but you won't be above 
to get in. Don't worry, you have to be turned away at least once before I 
can let you in. Type "MAIL" at the next menu to get to the GEnie mail section. 


7) Send a short not to me (address SWATSON) saying simply "Let me in". To 
send the letter you must type an asterisk character ('*') and a 's' 
character at the beginning of a new line like this: *s. 


8) We usually do the unlocking each business day, but don't get upset if 
it takes us up to three business days. You won't receive any notice about 
being unlocked, but can check quickly by typing "FREESOFT" at any GEnie 
menu to attempt to enter the FreeSoft RoundTable. 


Macro Keys 


Once you've started using various services regularly, you'll find that 
you'll be typing many of the same words and commands over and over. Macro 
Keys are used to send up to 40 pre-stored characters with only one keystroke. 
There are 30 macro keys, divided into 3 sets of ten keys each. Each set has 
macro keys numbered O to 9. To send a macro key, you hold down the COMMAND 
key and type a numeral from O to 9 corresponding to the Macro Key you wish to 
send. To make one of the three sets "active" (choosable with the mouse or 
keyboard), you'll use the scroll buttons in the Macros Status Bar as described 
a little later. 


To store characters inside a macro key, select the Edit Macro Keys choice 


from the Edit menu. You'll first see a dialog box asking you to speci fy 
which set and macro key number in that set to edit. After choosing the set 
and key number, you'll see a new dialog box with two editable text boxes. The 


top box is titled "String:" and it contains the actual characters you wish 
that macro key to send. The bottom box is titled "Label:", and it contains a 
"name" you vish to give to that key. 


The label can be up to 13 characters long. They are used to describe what 
that macro key does, and they show up in the macro key buttons in the Macros 
Status Bar. 


A carriage return character js not automatically sent at the end of a macro 


key. However, it just so happens that there is a way to embed control 
characters in a macro key string, and there is a certain control character 
that is the same as what your RETURN key sends. This control character is 
CTRL-M. You specify control characters by preceding it with a caret 
character. To send a caret character, type in two carets side by side. 


Here's an unlikely (but illustrative) example: 


HELL O^ETHERE^MBOP^M 


This example would send the characters "HELLO", followed by a CONTROL E, 
followed by the characters "THERE" followed by a single caret character, 
followed by the characters “BOB", followed by a carriage return Cwhich is the 
same a CONTROL M». 


if the above makes perfect sense, you're in good shape. Otherwise, you 
need to go back and review the last few paragraphs until it is clearer. 


For the most part, the only control character you'll probably need to ever 
use is CONTROL M for carriage returns. Just remember that: 


HELLO THERE^M 
would send a carriage return at the end of "HELLO THERE", and: 
HELLO THERE 


would not. For those of you who have found the need to send linefeeds 
after carriage returns, your "magic" sequence becomes: 


HELLO THERE^M^J 


Macro keys are useful for holding passwords, commonly used commands, and 
even quick and dirty modem dialing commands. If you have a Hayes compatible 
modem you could set up a macro key that contains: 





ATDT 555-1212^M 


When you sent that macro key, it would issue the appropriate dialing 
command to dial touch-tone the number 555-1212. Please change that number 
before experimenting or you'll have a Directory Assistance operator who thinks 
he/she has a "breather" on the line while you're busy celebrating success. 


Remember that each macro key can only hold 40 characters, including any 
caret characters. If you try to enter more than 40, the surplus will be 
“lopped off" into oblivion. 


Like most Mac users, you'll probably want to use your mouse as much as 
possible. Remember how ve discussed the General Status Bar earlier? 
There's also a status bar for Macro Keys called Cobviously> the Macros 
Status Bar. You can have a look at this by selecting that choice from under 
the Mode menu. Here's a partial Macros Status Bar | set up: 


Call MAUG | Call GEnie E 
: :22 
Get E-Mail | Call Delphi 2 < ent 


Each Macro Key's label is shown in its respective box to help you identify 
its purpose. The top row of boxes displays Macro Keys numbers 0-4, (from left 
to right), and the bottom row displays Macro Keys numbers 5-9, To send a 
Macro Key, simply click your mouse inside the appropriate box. 


On the right hand side of the Macro Key Buttons you see a downward pointing 
arrow. By clicking this, you will scroll through the three sets of Macro 
Keys, making each set “active” (that is, choosable through the Macro Key 
Buttons and keyboard). To the right of that is the elapsed time clock, 
exactly the same as the one in the General Status Bar. 


Of course, you might doubt that a 40 character Macro Key could hold enough 
poop to do something as complicated as "Get E-Mail" implies, and you're right. 


A Macro Key string that begins with a backslash (which is directly above 
the RETURN key on your keyboard and not to be confused with the slash 
("/") character) specifies not a string of characters to send, but instead 
the name of a Procedure file you wish to execute immediately. This is a 
quicker way of executing Procedures than going through menu choices. 


If you set up a Macro Key in this way and hear two “beeps” when 
you click on the box, it means Red Ryder can't locate the Procedure 
file. It either doesn't exist by that name, or it isn't located on 
the same disk as Red Ryder. To execute a Procedure file on a disk 
other than the one Red Ryder is on, you need to precede the 
Procedure file name with the volume name it's located on. 


In other words, if the Procedure file named CALL COMPUSERVE is located on 
the disk named MY PROCEDURES, you would need to set up the Macro Key to read: 


\MY PROCEDURES:CALL COMPUSERVE 


The colon character is what separates the volume and file names. It's 
really a good idea to specify volume names no matter where the file is 
located, in order to avoid trouble later. 


You'll soon find that even 30 Macro Keys just aren't enough for your 
ever-growing sophisticated needs. Red Ryder allows you to save your Macro 
Keys in a disk file to be loaded in at a later date. Simply choose the 
appropriate choice Save Macro Keys or Load Macro Keys from the Edit 
menu to accomplish this. You'll find the Macro Keys file has a distinctive 
icon that looks like the one next to the Edit Macro Keys choice under the 
Edit menu. You can double-click on this icon (or single-click and select 
Open from the Finder's File menu) to start up Red Ryder. If you start it up 


— 


this way, the Macro Key file you clicked will be immediately loaded in. 


You can also use macro keys to set up special escape-code command sequences 
used by UTS2 and VT100 applications. To send an ESCAPE control character, use 
the sequence "^[" (caret-teft square bracket). 


There are also a few UT10O applications that use both the Backspace and DEL 
keys for different things in the same session. | suggest you select the 
“Backspace Key Is DEL Key" in the Keyboard Preferences menu command, and 
then put the string "^H" Ccaret-H) in a Macro Key button with the lable 
"Backspace". This works because a CTRL-H is what the Backspace key normally 
sends. 


Procedure Files 


A Procedure file is simply a set of instructions you want Red Ryder to 
follow. Sound like a computer program? It is exactly that, and Red Ryder is 
equipped with a powerful, yet easy to learn and use, computer language of its 
own with literally dozens of commands. Red Ryder's Procedure language was 
originally intended to be used for automatic dialing and logon for remote 
services. [t quickly became evident that the possibilities are literally 
endless, and the Procedure language has grown to several dozen powerful and 
easy to use commands. 


A Procedure file can be as simple as a two-liner that sets the 
communications parameters and dials a phone number, or a wild bugger that 
automates an entire session while you sleep. It's up to you how complex uou 
want to get. Start simple, experiment, learn, and have fun! 


Just like learning any other computer language, the best way to learn 
Procedure commands is to browse over the following command descriptions (not 
trying to memorize them), and then look at some examples, referring back to 
the command descriptions for a more complete understanding. Learn a few 
commands at a time, biting off more as you feel comfortable. The examples 


start easy, and work their way to complex. Although you'll be prepared to 
write your first procedure after looking at the first example, don't figure on 
being a master of this language in an hour - it may take several. The beauty 


of it is that you can make your procedures as simple or complex as suits your 
needs and ingenuity, so don't overdo it by moving too fast. 


You can execute a Procedure file in a number of ways: 
e By double-clicking the mouse button (or single-clicking and choosing Open 
from the Finder's File menu. If you start up Red Ryder this way, the 


Procedure file will be immediately executed. 


e By naming a Procedure file with the special name "RRJ$" on the same disk 


as Red Ryder - Red vili execute this file immediately upon starting up. If 
you create one of these, don't start up Red Ryder by double-clicking a 
Procedure file icon as only the "RRJ$" Procedure will be executed. The BRJ$ 


file can be used to bypass the title screen, or to set up a default 
configuration you like instead of using one left over from the last session. 


€ By using the Host Mode command DO. There is also a Procedure file 
command DO for executing one procedure by another. 


e Through a macro key. The first character of the macro key should be a 
backsiash ("\") followed by the Procedure filename (see below for the correct 
format of a filename). Don't get the backslash (which is directly above the 
RETURN key on your keyboard) confused with the slash ¢"/"). 


During the execution of a Procedure, the menu bar and Status Bar are locked 
out. Pressing your mouse button will abort the Procedure in 
progress. The status bar area will graphically invert (displaying white 
upon black? when Red realizes you've pressed the mouse button. 


Your keyboard, however, is not locked out and you may type freely at any 
time. This capability was added to Red Ryder so that you don't have to put 
secret information in a Procedure that you wouldn't want others to view or 
have access to. During a demonstration of Red Ryder, you might want to have a 
PROMPT command for your Name or user ID question (followed by a PAUSE and 
TYPE command), but you don’t want to TYPE your password in front of others. 
Just PROMPT for something that comes after the Password question, and type it 
in by hand. 


Procedure commands are shown in the Status Bar area as they are executed 
(unless you use a QUIET command to suppress this). 


A Procedure file is created with your favorite editor/word processor. If 
you use MacWrite, make sure you end each line with a carriage return and save 
the file using the "Text Only" option. | like to use the MockWrite desk 


accessory for creating short Procedure files while running Red Ryder, and 
others have recommended the Quick & Dirty Editor from Dreams Of The Phoenix. 
The "Edit" program from the Macintosh Development System (MDS) ts also a good 
tool for creating Procedure files. Once you have saved your Procedure file, 
select the Change TEXT To Procedure choice under the Service menu. This 


will give your Procedure a distinctive icon (like that found next to the 
Initiate Procedure choice, to keep it from getting mixed in with other TEXT 
files). If you need to change the Procedure once it has been given the 


distinctive icon, use the Change Procedure To TEXT choice under the 
Service menu to change it back to a TEXT file that can be loaded into your 
editor/word processor. You can't use either of the Change menu choices 
during a file send or receive. 


Changing a Procedure to TEXT and back several times can be a drag during 
debugging. A neat trick to save steps is to put the Procedure name in a macro 
key. A Procedure file in a macro key does not have to have the distinctive 
Procedure icon (it can be any kind of file, including TEXT>. Once | have the 
Procedure working the way | like, | give it the distinctive icon so that it 
can be chosen from the Initiate Procedure command. 


All Procedure command lines must be 80 characters long or less. 
Having a line longer than this can cause serious and unpredictable 
errors. 


It's absolutely essential that you specify the filename type arguements 
correctly. Remember that filename consists of the volume's name, a colon, 
and the file's name. The file "My File" on the volume "My Disk" would be 
specified “My Disk:My File”. Specifying the wrong filename can have various 
effects, depending on the command. The SEND commands for example, will give 
you a "File Not Found" error message. The MACRO command will sound two short 
beeps. The RUN command will probably cause a complete system crash! You are 
warned to be careful. 


Enter the Procedure commands exactly as they are shown below. Spelling 
errors, leading, trailing, or unnecessary blanks are all guaranteed to cause 


problems. Spelling errors usually result in an "Illegal Procedure Command" 
message box. A CLOSE command encountered when an ASCII file receive is not 
in progress will also yield the "Illegal Procedure Command" message. 


If the last command in your Procedure file does not seem to execute, you 
probably forgot to put a carriage return at the end of it. All Procedure 
command lines must end with a carriage return. In other words, don't let the 
automatic wrap-around feature of some word processors and text editors take 
you to the next line - always press your RETURN key at the end of each 
Procedure command line as you type them in. 


Always put a PAUSE command after a PROMPT command. Many remote systems 
need a moment or two to settle down before you defuge it with characters, such 
as through a TYPE command. 


If you just can't make a PROMPT command work, you're probably doing one of 
three things: 
13 Not prompting for the correct string ("VOU HAVE MAIL", "You Have 
Mail” and “you have mail" are three different strings because of the 
upper and lowercase letters). 


DO filename 


Function: Immediately stops execution of the current Procedure file and 
begins execution of the Procedure file filename. 
Example 


TYPE Now branching to mail routine...*M 
DO MYDISK: MAIL PROCEDURE 


RUN filename 


Function: Immediately exits Red Ryder and begins execution of the Macintosh 
application filename. If this file doesn't exist, you will probably get a 
system crash - so be careful. 

Example: 


RUN MYDISK:MacWrite 


WAIT hh:mm:ss 

Function: Waits until the time specified in hh:mm:ss before executing the 
next procedure command. hh is hours, mm is minutes, and ss is seconds. All 
must have leading zeros if they are less than 10, and are in 24-hour military 
format (i.e. 10:32:00 p.m. would be 22:32:00). 

Example: 

WAIT 01:30:00 

TYPE It's now 1:30 in the morning! *M 

WAIT 15:30:00 

TYPE It's now 3:30 in the afternoon! *M 


QUIT 

Function: Immediately exits Red Ryder and returns to the Finder. 
Example: 

(Returning to Finder...) 

QUIT 


QUIET 


Function: Causes no further Procedure commands to appear in the Status Bar 
area as they execute. Use this to keep passwords or other information secret, 
or to prevent short procedures from distracting you. 

Example: 

TYPE No further commands will be displayed*M 

QUIET 


LOUD 

Function: Used after a QUIET command to again display Procedure commands in 
the Status Bar area. 

Example: 

QUIET 

TYPE MYPRSSHORD*M 

LOUD 

TYPE MYNRME^M 


PAUSE 

Function: Delays for two seconds before executing next Procedure command. 
Example: 

PROMPT CONNECT 

PRUSE 


TYPE MYNAME*M 
TYPE MYPASSWORD*M 
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BELL 

Function: Causes the Macintosh to emit a short beep sound. Useful to alert 
you during various stages of a Procedure execution. 

Example: 

TYPE One ringy-dingu! 'M 

BELL 


PRNICO 

PRNIC1 filename 

PRNIC2 filename 

PRNIC3 filename 

PRNIC4 filename 

PANICS filename 

PANIC6 filename 

PRNIC? filename 

PRNIC8 filename 

PRNIC9 filename 

Function: These 10 commands are used in conjuntion with the PROMPT command. 
If the string you have specified in the last PROMPT command does not come 
over the line in the specified number of minutes, the Procedure file 
filename is immediately executed. That file typically will contain 
instructions for disconnecting the modem. The number of minutes to wait is 
placed directiu after the command PANIC (no spaces in there!) and is a number 
from 1 to 9. There is a single space betueen the number of minutes and 
filename. To disable the PANIC timer, use a PANICO command (that's a 
zero). Once the PANIC timer is started, it continues to run until a PRNICO 
is executed or a new PANIC time is specified. 

Example: 

(Wait 5 minutes for the string "FINISHED" > 

PRNICS MV DISK:Hang Up Phone 

(Or hang up the phone if | don't get it) 

PROMPT FINISHED 

(| got it! Now disable the PANIC timer) 

PRNICO 

(That's a zero after the "C"? 


DELETE filename 

Function: This command deletes the file filename. No verification if you 
really want to do that is supplied as is with the Delete A File menu 
command, so be cautious about how you use this Procedure command. 

Example: 

DELETE DataDisk: OI dNews 


ommunications Parameters/ m Configuration 
RESET 
Function: This resets the elapsed timer to 00:00:00. 
Example: 
PROMPT CONNECT 
RESET 


COMM baud-parity-databi ts-stopbi ts-dupl ex 
Function: This sets up the communications parameters. The hyphens between the 
parameters are necessary. 

baud - 300, 450, 1200, 2400, 4800, or 9600 
parity - N, E,O,K,or S 

databits - 7 or 8 

stopbits - 1 or 2 

duplex - FULL, HALF, or ECHO 

Example: 

COMM 1200-N-8-1-FULL 

COMM 300-E-7-2-HALF 


DISPLAY 40 

DISPLAY 80 

DISPLAY 132 

Function: This commands select either the 40 X 12, 80 X 24, or 132 X 24 
display modes. The mode selected must be compatible with the emulation being 
used (i.e. can use 40 X 12 only with TTY emulation) or the command will be 
ignored. 

Example: 

(Select UT100 Emulation and 132 X 24 display? 

UT100 

DISPLAY 132 


TTY 

Function: Causes Red Ryder to use TTY emulation. 
Example: 

COMM 300-N-8-1-FULL 

TTY 


UT52 

Function: Causes Red Ryder to use UT52 emulation. 
Example: 

COMM 300-N-8-1-FULL 

UTS2 


UT100 

Function: Causes Red Ryder to use UT100 emulation. 
Example: 

COMM 300-N-8-1-FULL 

VT 100 


GBAR 

Function: When Procedure is finished executing, display the General Status 
Bar. 

Example: 

COMM 300-N-8-1-FULL 

TTY 

GBAR 


TBAR 

Function: Has nothing to do with sexy underwear. When Procedure is finished 
executing, display the Tabs Status Bar. 

Example: 

COMM 300-N-8-1-FULL 

TTY 

TBAR 


MBAR 
Function: When Procedure is finished executing, display the Macros Status Bar. 
Example: 

COMM 300-N-8-1-FULL 
TTY 

MBAR 
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UBRR 

Function: When Procedure is finished executing, display the UT100 Status Bar. 
Example: 

COMM 300-N-8-1-FULL 

UT100 

UBAR 


CLEAR 

Function: Clears the display screen. 
Example: 

COMM 300-N-8-1-FULL 

DIAL ATDT 555-1212 

PROMPT CONNECT 

CLEAR 


MACRO filename 


Function: Loads in the Macro Keys file filename. If the Macro Keys file 
can't be found, you'll hear two short beeps and the Procedure will be aborted. 
Examples: 


COMM 300-N-8-1-FULL 
MACRO MYDISK:CompuServe Macros 
DIAL 355-1212 


STRIP switch 

Function: Tells Red Ryder whether or not to strip control characters out 
during ASCII file receives, or during TEXT file receives under Kermit. 
switch is either OFF or ON. 

Example: 

(Strip out control characters) 

STRIP ON 

(Don't strip control characters) 

STRIP OFF 


ESC switch 

Function: equivalent to turning on or off the Enter Key Is ESC Key choice 
in the Keyboard Preferences dialog box. 

switch is either OFF or ON. 

Exanple: 

(Map the ENTER key as an ESCAPE key) 

ESC ON 


DEL switch 

Function: equivalent to turning on or off the Backspace Key Is DEL Key 
choice in the Keyboard Preferences dialog box. 

switch is either OFF or ON. 

Example: 

(Make the BACKSPACE key send DEL characters) 

DEL ON 


ANSWERBACK string 

Function: sets the UT100 answerback string to string in the same manner as 
the VT100 Modes dialog box. string must be 30 characters or less 

and may contain control characters specified in the same manner as in a Macro 
Key string. 

Example: 

(Set up my answerback string with my secret access code) 

ANSWERBACK AB123”M 


LF switch 

Function: Tells Red Ryder whether or not to send linefeeds after carriage 
returns. switch is either OFF or ON. 

Examp!e: 

(Send LF's after CR's) 


LF ON 
(Don't send LF's after CR's) 
LF OFF 


SLOW switch 

Function: Tells Red Ryder whether or not to use slow timeouts for XMODEM file 
transfers. switch is either OFF or ON. 

Example: 

(Use slow timeouts for XMODEM - 10 seconds) 

SLOW ON 

(Don't use slow timeouts for XMODEM - 5 seconds? 

SLOW OFF 


MODEM 

PRINTER 

Function: These two commands tell Red Ryder whether to use the modem port or 
the printer port for communicating with the modem, 

Example: 

(Change to the modem port) 

MODEM 

(Change to the printer port) 

PRINTER 


CONTROL1 char 

CONTROL2 char 

CONTROL3 char 

Funetion: These three commands allow you to change the control characters sent 
Dy the three control character buttons in the General Status Bar. The buttons 
are numbered 1, 2, and 3 from left to right. No space is between the CONTROL 
and button number, but there is a single space between the button number and 
char. char should be a letter from A to 2. 

Example: 

(Set up the General Status Bar to have Control-A, Control-B? 

Cand Control-C characters from left to right) 

CONTROL1 A 

CONTROL2 B 

CONTROL3 C 


File Transfers 


RECA filename 

RECX filename 

RECK filename 

Function: These three commands work like their Host Mode counterparts, telling 
Red Ryder to receive the file filename using ASCII, XMODEM, or Kermit 
protocols. To prevent an unattended Procedure from staying on the phone all 
night if something goes wrong during a file transfer, the XMODEM and Kermit 
receives will abort after 15 cumulative errors. 

Example: 

RECX MYDISK:MYFILE 


SENDA filename 

SENDX filenane 

SENDK filename 

Function: These three commands work like their Host Mode counterparts, telling 
Red Ryder to send the file filename using RSCII, XMODEM, or Kermit 

protocols. To prevent an unattended Procedure from staying on the phone all 
night if something goes wrong during a file transfer, the XMODEM and Kermit 
sends will abort after 15 cumulative errors. 

Example: 

SENDX MYDISK:MYFILE 


CLOSE 

Function: Manually ends an ASCII file receive. If you execute this command 
when a file not being received, you will get an "Illegal Procedure Command" 
error message. 

Example: 


RECA MYDISK: Messages 
PROMPT No more messages 
CLOSE 


ialing an edialin 


DIAL dialstring 

Function: This command works just like the Dial Or Redial A Number choice 
under the Service menu. You can embed control characters in dialstring by 
preceding them with a caret, but you don't need to put a “M at the end (the 
carriage return is supplied automatically). dialstring must be 70 
characters long or less. Many people will point out that this and the TYPE 
command are similar. They are with one exception: a number dialed using the 
DIAL command rather than the TYPE command can be redialed at a later time by 
choosing the Dial Or Redial A Number choice under the Service menu. 
Example: 

COMM 300-N-8-1-FULL 

(Make sure the modem is ready) 

TYPE RT^M 

TYPE RT^M 

TYPE RT^M 

PRUSE 

DIRL RTDT 555-1212 


REDIAL dialing string 

Function: This command works just like the Dial command, except it 
continuously redials a busy number until a connection is established. When a 
connection is established, execution of the Procedure continues. Note that 
aborting the redial will also cancel the Procedure. 

Example: 

COMM 300-N-8-1-FULL 

(Make sure the modem is ready») 

TYPE AT^M 

TYPE AT*M 

REDIAL ATDT 555-1212 

(If | get to this instruction, a connection has been made! > 

(So... never use a PROMPT after a REDIAL! > 

TYPE MYNAME*M 


WRITE filename 

Function: This command does exactly the same thing as the Print TEXT File 
choice under the Local menu. The lmageuriter must be connected and selected. 
If it is connected but turned off, or not connected at all, this command is 
not executed. If it is connected, turned on, but not selected, it will wait 
for gou to push the printer's "Select" button. This command is ignored if uou 
are doing an ASCI! file transfer. 

Example: 

WRITE MYDISK:Messages 


SCREENCOPY 

Function: This command does exactly the same thing as the "Dump Screen To 
Printer" button in the General Status Bar. See the WRITE command above for 
cautions about printer hookup and select-state. No printing is done if you 
are doing a file transfer. 

Example: 

PROMPT Logging off at: 

SCREENCOPY 

(Capture the amount of time | was on-line for my records) 


ECHO ON 

ECHO OFF 

Function: These commands turn on and off the echoing of all incoming data to 
the |magewriter printer. 

Example: 

(Send all incoming data to the printer) 


ECHO ON 
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TYPE string 

Function: This sends string over the modem as if you had typed it on your 
keyboard. Control characters can be embedded in string in exactly the same 
manner as they are in Macro Keys. A carriage return is not automatically sent 
at the end of string, you must tell it to do so explicitlu with the “H 
sequence. |f you need to send a linefeed after a carriage return, use the 
sequence ^M^J. 

Example: 

(Send a Control-C) 

TYPE °C 

(Send the string "HELLO" followed by a carriage return? 

TVPE HELLO^M 

(Send the string "HELLO" with no carriage return at the end? 

TYPE HELLO 


PROMPT string 

Function: This waits for the exact string of characters string to come over 
the modem before executing the next Procedure command. Upper and lowercase 
characters are different and must match. Vou mau not embed control characters 
in string, to do this use the PROMPT “char command below. string may be 


up to 20 characters long. It is recommended that you use as few characters as 
possible to make string unique. 
Example: 


PROMPT NECT 

(Trap the last four characters of the modem's CONNECT > 
(message before continuing? 

TYPE Hello and welcome to Scott's Macintosh! ^M 

TYPE Now going to Host Mode*M 

HOST 


PROMPT ^char 

Function: Waits for the control character char to come over the modem before 
executing the next Procedure command. char should be an uppercase letter 
from A to Z. There is a single space between PROMPT and the caret, but no 
space betueen the caret and char. 

Example: 

PROMPT ^C 

(Wait for a Control-C character) 

TYPE Connected! ^M 


SHORT BRERK 


Function: sends a short (233 millisecond) modem BREAK signal if the modem is 
equipped to support it. 
Example: 


(Send a short BREAK signal now) 
SHORT BREAK 


LONG BREAK 
Function: sends a long (3 1/2 - 4 second ) modem BREAK signal if the modem is 
equipped to support it. 


Example: 
(Send a long BREAK signal now) 
LONG BREAK 
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ALERT! string/command 

ALERT2 string/command 

ALERT3 string/command 

Function: These three commands let you look for more than one string to come 
over the modem, and do different commands (typically JUMPTO commands? 
depending on the string received. string must be less than 20 characters and 
upper and lowercase letters are different and must match. These commands do 
not hold up execution of the Procedure while waiting for the string to come 
over the modem. Control characters cannot be embedded in string. command 
is a full and valid Procedure command to be executed immediately when that 
string is received. To disable an ALERT command, simply include the proper 
ALERT number command with no string/command supplied. Anytime an ALERT or 
PROMPT string is received, all active ALERT and PROMPT commands are 
disabled. There is a single space between the ALERT number and string, but 
no spaces between string, the slash character, and command. Don't confuse 
the slash character, which is directly to the left of the righthand SHIFT key 
on your keyboard, with the backslash character ("X"). 

Example: 

(Wait for either "you have mail” or the string) 

("Command?" and branch to appropriate routine?) 

ALERT1 you have mai 1/JUMPTO (GET MAIL) 

PROMPT Command? 

(| got the "Command?" string so | JUMPTO somewhere else? 

JUMPTO (DO COMMAND > 

(GET MAIL? 

Cif | get here, | got the "you have mail” string and need to) 

(handle that) 


Letting Red Ryder Write A 
Procedure For You 


The Write A Procedure For Me menu command under the Service menu can 
be used to write Ruto-logon Procedures, Procedures to be called while inside a 
service, or even full session unattended Procedures. It basically monitors 
incoming and outgoing data and generates the proper Procedure commands to 
navigate in a mirror image fashion of your actions. Of course, this presumes 
that the host will react in a consistent manner from session to session. If 
it doesn't, a small amount of fine tuning may be necessary. 


After selecting the Write A Procedure For Me command, you will be 
prompted to enter the resulting filename for the Procedure. t'II be saved as 
a Procedure file, rather than as a TEXT file. After specifying the name, 
you'll be asked whether or not you wish the Procedure to begin by intializing 
the system to all current terminal settings. If you answer affirmatively, all 
of the Procedure commands (such as COMM, SLOW ON, CONTROL1, etc) applying to 
settings parameters will be generated. It will also include a short sequence 


for initializing a Hayes compatible modem: 


TYPE AT^M 
PAUSE 


TYPE AT^M 
PAUSE 
TYPE AT^M 
PAUSE 


This matches baud rates and prepares the modem for a dialing command (you 
can edit out this sequence or modify it appropriately if you don't have a 
Hayes compatible modem). You should answer Yes to this prompt only if your 
Procedure will begin by dialing a service. For procedures that will be 
executed while already inside of a service, you would not want all of the 
intialization stuff to occur. 


For this reason, you must have all settings the way you want them before 
you choose the Write A Procedure For Me command. Once the Procedure 
generation has begun, clicking on the baud rate (for instance) parameter will 
not be recorded in the Procedure file. A small number of menu command 
selections are supported during Procedure generation, they're discussed below. 


A good number of people (like me) have gotten into the shortcut habit of 
just typing the modem dialing command, rather than by using the Dial Or 
Redial A Number menu command. This habit must be broken for use with the 
Write A Procedure For Me command. It is absolutely essential that you use 
the Dial Or Redial A Number menu command for dialing a service when 
generating a Procedure, or the resulting Procedure vill most likely not work 
properly. 


The Write A Procedure For Me command saves uninterrupted typing 
sequences, and then generates TYPE Procedure commands for the sequence when 
it's interrupted. A typing sequence is interrupted by a carriage return, 
either incoming from the host, or outgoing from the keyboard. If it's 
outgoing from the keyboard the letters ^M are appended to the end of the TYPE 
command to show that you typed a RETURN. When it's interrupted, Red Ryder 
looks at the line you were typing on to determine whether you were typing in 
response to a prompt from the host. If your typing began on the first column 
of the line, no PROMPT statement is generated. Otherwise, up to 10 characters 
preceding the first character you typed are used to generate a PROMPT command 
Cwhich is followed by a PAUSE command). 


The following menu command actions will be saved in the Procedure file: 

e Load Macro Keys 

e File receives 

e Manual closing of an ASCII file receive. 

e File sends 

e Print TEXT File 

e Delete A File 

When you choose one of the above menu command actions, Red Ryder wili again 
look at the most recent line received, if the line is empty, the appropriate 
Procedure command for the Menu choice will be placed immediately after the 
last command in the Procedure file. If the line isn't empty, Red will want to 


know if you did that menu action in response to a prompt from the host. 


Let's look at an example of both methods. Before you used a Dial Or 
Redial A Number menu command, you might want to load in a set of macro keys 
from a file. Since you didn't do that menu command in response to any prompt 
from a host (you aren't even connected to a host yet!), you wouldn't want a 
PROMPT command generated before the menu action command. 


However, opening a receive file to capture all new messages probably would 
be in response to a prompt from the host, and you would want such a PROMPT 
generated in the Procedure file. 


For those menu command actions that require the selection or creation of a 
file, the Procedure generation routine will ask you to type in the filename 
of what you just selected or created. If that sounds redundant, just realize 
that Red Ryder is a bit stupid in this regard, but that information is needed 


to properly complete the generation of such Procedure commands as MACRO and 
RECA Camont others). 


Hints And Ti 


1> The Write A Procedure For Me menu choice turns into Stop Creating 
The Procedure while Procedure generation is active. Choose it to finish 
generating the Procedure file. 


2) While generating a Procedure file, type slowly and deliberately. Typing 
errors, backspacing, etc. will be repeated verbatim for the next billion years 
Cor however fong you continue to use that Procedure). 


3) When a menu command and typing action are to take place after the same 
prompt from the host (like opening a receive file and then typing the command 
to list all new messages), choose the menu action first if possible (so that 
the PROMPT command will be placed before the menu action command, followed 
immediately by the typing sequence). A typing sequence must never be 
interrupted by a menu command action - do one before or after the other only. 
However, if you're going to be sending or receiving a file using Kermit or 
XMODEM, you'll find that the keyboard is locked out after the menu command is 
executed, so in this case the typing sequence would come first, followed by 
the menu action. 


4) The logic for this command was derived by observation, and there's 
always room for improvement and added utility. Please pass along any comments 
or suggestions to me so | can incorporate them in future versions. 


5) Break signals, VT100 status bar and numeric keypad sequences, and 
automatic UT1OO cursor key positioning are not yet supported in Procedure 
generation (but will be). Typing sequences are limited to normal ASCII 
alphanumeric and control keys. 


Hhu Would | Want To Edit A Generated Procedure? 


CompuServe is a good example of a inconsistent host. The first menu you 
may see after logging on is unpredictable - it may be either the top level 
command menu or the electronic mail menu if you have messages waiting. On the 
dark side, the prompts for these two menus are quite different, so a generated 
Procedure may get "hung up" because it expects the prompt for a menu that 
never arrives. On the bright side, since both menus use an exclamation point 
("1") as the last character in the prompt, the generated Procedure can be 
easily edited to look for only that character in the first menu PROMPT 
command. The ability to generate Procedures with sel f-modi fying commands for 
conditional routines never seen before is certainly feasible and forthcoming. 


Procedure Examples 


Examples of every Procedure command would cause this documentation to swel | 


to an unpractical size. However, it is hoped that the examples below will get 
you started, and the examples that have already begun circulating by user 
groups and BBS's will further your education. The chances are very good that 
a user's manual devoted solely to Procedures will be constructed and 


distributed to registered users (if this not already the case by the time you 
are reading this). 


Let's start with something simple. 


Example $1: | want to call Big Bob's BBS using 1200 Baud, NO Parity, ? Data 
Bits, 1 Stop Bit, and FULL Duplex. The number is (000)555-1212. I'm using a 
Hayes compatible modem. Please note that this is a bogus phone number. 


COMM 1200-N-8-1-FULL 
DIAL ATDT 1 000 555 1212 


Example 2: Here's how | log onto CompuServe (using a CIS node - not Telenet! ). 
| have a Macro Keys file named CIS MACROS on the disk named MYDISK that | want 
to load in, also. 


COMM 1200-N-8-1-FULL 

(Set the communications parameters) 

MACRO MYDISK:CIS MACROS 

(Load in my Macro Keys file) 

DIAL ATDT 555-1212 

(Now dial my local access number > 

PROMPT NECT 

(I'm waiting for the last part of the message CONNECT from the modem) 
RESET 

(reset my elapsed timer to 00:00:00 so 1 know how long I've been on) 
PAUSE 

(hang loose a second for the connection to get established solidly? 
TYPE ^C 

(need to send them a CONTROL-C to get started) 


PROMPT ID 
(CompuServe asks me for "User ID:"» 
PRUSE 


(Always use a PAUSE after a PROMPT!) 

TYPE 73176,61^M 

(Type in my user ID with a carriage return at the end) 
PROMPT word 

(Now CIS asks me "Password: "> 

PRUSE 

(Give the line a chance to settle down) 

TVPE MV/SECRET^M 

(1 type in my password now) 

PROMPT ! 

(This is the character CIS uses for a command prompt, so | tell them: > 
PAUSE 

(Getting the hang of this PROMPT/PAUSE routine, now?) 
TYPE GO PCS-23°M 

(Onward to MAUG! > 


(Hey human, ol’ Red did all the work! Wake up! Wake up!) 


Example 3: I've just downloaded a neat program called FEDIT, put it on a disk 
called GREAT UTILITIES and three of my buddies want a copy. | just hook up my 
modem to answer the phone, tell them to give me a call, type in the secret 
password GOOBER, and my Mac will send the file XMODEM. I'm going to put this 
Procedure on that same disk and call it BUDDIES PROCEDURE. Of course, uhile 
one guy's online, the other two have their Red Ryder's set up for 


redialing.... Remember that in order for this to work, all of your 
buddies have to call in using 300-N-8-1-FULL parameters. 


COMM 300-N-8-1-FULL 

(Always one guy in the crowd who slows everybody down!) 

PROMPT GOOBER 

(| can ignore everything else until my secret password comes in!) 
SENDX GREAT UTILITIES:FEDIT 2.0 

(Send that file, Red!) 

DO GREAT UTILITIES:BUDDIES PROCEDURE 

(Start this procedure over again for whoever's left.) 


Example 4: Here's my super-simple Hang Up The Phone procedure that | like to 
link through a Macro Key. Works only with Hayes and compatible modems. 


TYPE +++ 
PROMPT OK 


(Apple and USR modem owners can skip the fol lowing) 
TYPE ATH*M 


Example 5: I'm going to send a copy of Red Ryder 9.0 (?!?) to my buddy. On my 
computer, | execute the following Procedure: 


PROMPT BEGIN 

(His Procedure will send the string "BEGIN" when it's ready!) 
SENDX Red Ryder Master:Red Ryder 9.0 

SENDX Red Ryder Master:Red Ryder Documentation #1 

SENDX Red Ryder Master:Red Ryder Documentation $2 

SENDX Red Ryder Master:Red Ryder Documentation #3 

SENDX Red Ryder Master:Red Ryder Documentation #4 


And my buddy at the same time executes the following Procedure on his machine: 


TYPE BEGIN 

RECX Fresh Disk:Red Ryder 9.0 

RECX Fresh Disk:Red Ryder Documentation $1 
RECX Fresh Disk:Red Ryder Documentation $2 
RECX Fresh Disk:Red Ryder Documentation #3 
RECX Fresh Disk:Red Ryder Documentation #4 


BELL 

BELL 

BELL 

BELL 

Example 6: | like to selectively turn on and off the capturing of certain 
information to my disk for later archiving and perusal. | want the archive 
file to be named "Stored Data" on the disk named "Data Disk" and the following 
Procedures wil! be on the disk named "Red Ryder" 


1» Create the following procedure and save it on the disk "Red Ryder” with the 
name "Capture On". 


QUIET 
RECA Data Disk:Stored Data 


2) Create the following procedure and save it on the disk "Red Ryder” with the 
name “Capture Off". 


QUIET 
CLOSE 


3) Put the following string into Set #1, Macro Key #8 
\Red Ryder: Capture On 


4» Put the following string into Set #1, Macro Key #9 


\Red Ryder:Capture Off 


Give those two Macro Keys appropriate labels, while you're at it, (Capture On 
and Capture Off would be fine). 


Now, when ever you select Macro Key #8 from Set #1, incoming data wil! be 
directed to the file “Stored Data” on the disk "Data Disk". Select Macro Key 
#9 from Set $1 to turn off this saving of incoming data. When you have the 
Macros Status Bar on the screen, you can turn the capturing on and off with a 
click of your mouse! 


Example 7: | want to use Host Mode when | get home from work, but | don't 
want anyone else being able to get in except me. The following Procedure 
waits for the secret password "GRZORK" before letting me into the Host Mode. 
l'm going to name this Procedure "Password" on the disk "MVDISK". 


TYPE Password protect installed. Hang up now...*M 
PROMPT GAZORK 

TYPE Now going to Host Mode. Type in the command^M 
TYPE "DO MYDISK:Password" when you're done*M 

HOST 


Example 8: Redialing one service is fine, but let's get real clever and 
redial 4 services (or more if you wanted) in a daisy-chain fashion. When you 
get connected, Red rings like crazy till you push your mouse button Cwhich 
aborts the Procedure). This procedure assumes that the communications 
parameters are the same for all four services, and have been set before this 
Procedure is executed. The two ALERT commands are used to trap the modem's 
“NO CARRIER" and "BUSY" messages, and the PROMPT is used to trap the 
"CONNECT" message. 


(FIRST?) 

DIRL RTDT 555-1111 

RLERT1 CARR/JUMPTO «SECOND? 
RLERT2 BUSV/JUMPTO (SECOND) 
PROMPT NECT 

JUMPTO CONLINE! > 

(SECOND) 

DIAL ATDT 555-2222 

RLERT1 CRRRIER/JUMPTO (THIRD)? 
ALERT2 BUSV/JUMPTO «THIRD? 
PROMPT NECT 

JUMPTO CONLINE! > 

(THIRD) 

DIAL ATDT 555-3333 

ALERT! CRRRIER/JUMPTO (FOURTH) 
ALERT2 BUSY/JUMPTO (FOURTH? 
PROMPT NECT 

JUMPTO «ONLINE! > 

(FOURTH) 

DIAL ATDT 555-4444 

ALERT? CRRRIER/JUMPTO (FIRST)? 
RLERT2 BUSV/JUMPTO «FIRST» 
PROMPT NECT 

CONL I NE! > 

BELL 

JUMPTO (ONLINE!) 


Example 9: When you change your communications parameters, your Hayes 
compatible modem may or may not be ready to immediately respond to further 
commands. What you need to do first is get the modem to recognize your new 
parameters by typing the "attention" command a few times until your modem 
responds yith the message "OK". The following routine should be used after 
any COMM command. 


COMM 1200-N-8-1-FULL 
TYPE RT^M 

PRUSE 

TYPE RT^M 

PRUSE 


DIAL 355-1212 
(Rest of Procedure goes here) 


Using the Procedure commands in new and novel ways wili make Red Ryder's 
possibilities almost endless. A few ideas that come to mind are: 


1» Upload a Procedure file to the Host Mode and then use the Host Mode command 
DO to execute it. 


2) Use the WAIT command to send out daily updated information to customers or 
employees in the field during the evening hours when phone rates are lower. 
The remote people put their machine in Host Mode before leaving the office for 
the evening. 


3) You can reserve one of your Macro Keys to execute q Procedure that loads in 
a new set of Macro Keys (ad infini tum? - a good way to extend the number of 
Macro Keys available above 30. 


4> Let Red Ryder do the work for you! Use the Procedures generated by the 
Write A Procedure For Me menu command to get a good starting point to 
build on once connected to a system. 


Customizing The 
Communcations Interface 


RED FLAG NOTE: The information in this chapter is intended only 
for very experienced Red Ryder users who have a good working 
knowledge of how to construct DLOG and DITL resources using 
Apple's ResEdit program. The below information contains 
references to terms found in the Dialog Manager, Window Manager, 
and QuickDraw chapters of Inside Macintosh, so you should already 
be familiar with these before attempting to use the following 
information. 


These is a first draft document, and as such I admit it's pretty 
sloppy. Hopefully, | can improve this soon and include more 
examples. 


The QUERY1, QUERY2, QUERY3, QUERY4, and QUERYS Procedure 
commands provide an easy means to include programmed dialog boxes in your 
Procedure Files. Red Ryder has the additional intelligence needed to process 
customized dialog boxes that can include multiple items of such types as simple 
Pushbuttons, Radio Controls, Icons, Checkboxes, Pictures (PICT items), 
Editable Text, and Static Text. If you have a good working knowledge about 
how dialog boxes are created using Apple's ResEdit program and how the 
above items function according to Apple's user interface guidelines, you can 
use this feature to provide a customized communications interface for yourself 
and others. 


The items in your dialog box can be divided into several functional categories: 


* Non-selectable and non-returning display items: These items, like Static Text, 
Editable Text, and non-selectable Pictures (PICT items) and Icons are used 
either to convey or gather information from the user while the dialog box is 
active. A user mouse action in an item of this type is ignored. 


* Selectable but non-returning items: These items, which consist of Radio 
Controls and Checkboxes, are used to display current settings, and allow the 
user to change them while the dialog box is active. You can have up to 20 
checkboxes in your dialog box, and up to 20 groups of radio controls (with an 
unlimited number of radio controls in each group). The tracking of these items 
(checking or unchecking of checkboxes and selection of a radio control and 
deselection of all other radio controls in the same group) is done automatically 
by Red Ryder. 


* Selectable returning items: These items, pushbuttons or a special entity called 
a special pushbutton (discussed later) are used to close down the dialog box 
and resume execution of the Procedure. 


The interface between your Procedure File (which calls up the dialog box) is 
quite simple. Before bringing up the dialog box, if you have any checkbox or 
radio control items, you can set their values using the following two Procedure 
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commands: 


SETBOX NUM_EXP 1, NUM_EXP2 

Description: This command sets the value of checkbox number NUM_EXP 1 
(which is a value between 1 and 20». NUMLEXP2 should be either zero 
(which means the box is not checkmarked) or one (which means the box is 
checkmarked). 

Example: 

(Set checkbox #1 to be uncheckmarked? 

SETBOX 1,0 

(Set checkbox #5 to be checkmarked) 

SETBOX 5,1 


SETGROUP NUM_EXP 1, NUM_EXP2 


Description: This command is used to designate which radio control in a 
group is selected. NUM_EXPI is the group number (from 1 to 20). 
NUM_EXP2 is the radio control number in the group that is the selected 
control (from 1 to the number of radio controls in the group). 

Example: 

(| have two groups of radio controls. Group #1 has 3 radio controls, » 
cand number 2 is the selected control. Group $2 has 2 radio controls, > 
Cand number 1 is the selected control. > 

(Set group #1 so that control #2 is the selected one) 

SETGROUP 1,2 

(Set group #2 so that contro! #1 is the selected one) 

SETGROUP 2, 1 


To execute the dialog box, the SHELL command is used. Until the user clicks 
the mouse inside a Pushbutton or Special Pushbutton item, the Procedure File 
is suspended. When the user does, the item number clicked on is returned in a 
numeric variable supplied with the SHELL command. 


SHELL NUM_VAR, NUM_EXP 


Description: This command is used to execute a dialog box. NUM_VAR is 
the numeric variable that will hold the item number of the pushbutton or 
special pushbutton that the user clicked on to exit the dialog. NUM_EXP 
is the resource ID numbers of the DLOG and DITL resources of the dialog 
box. Execution of the Procedure File is suspended until the user exits 
the dialog box. 

Example: 

(Hide the Terminal Display Window to make my display pretty) 

SCREEN OFF 

(Now execute the dialog box with resource ID number 1000, and return to» 
(me after the user exits with the item number he clicked on the exit in) 
(the numeric variable AZ) 

SHELL AZ, 1000 

CAR now holds the ¡tem number of the exiting pushbutton? 
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Once you have returned from the dialog box, two more Procedure commands 
can be used to find out what changes (if any) were made to any checkboxes and 
radio controls. 


GETBOX NUM_VAR , NUM_EXP 


Description: This command is used to interrogate the status of a 
checkbox. NUM_VAR will hold a zero if the checkbox is not checkmarked, 
or a one if the checkbox is checkmarked. NUM_EXP is the checkbox number 
(from 1 to 20) to interrogate. 

Example: 

(Find out if checkbox number 15 is checkmarked) 

GETBOX AZ, 15 

TEST AZ = 1 

(Ring the bell if it is? 

IF VES BELL 


GETGROUP NUM_VAR, NUM_EXP 


Description: This command is used to interrogate a group of radio 
controls to find out which radio control is the selected one in the 
group. NUM_VAR is a numeric variable that will contain the member 
number of the selected control in group number NUM_EXP (a number from 1 
to 20). 

Example: 

(Tell me which radio control member is selected in group #3) 

GETGROUP RfR$,3 

(R$ now holds the selected member number. 


Think of a radio control as having three separate identities: its item number in 
the dialog, the group number it belongs to, and its member number in the group. 
A checkbox has only two identities: its item number in the dialog, and its 
checkbox number. Other items have only one identity: their item number in the 
dialog box. 


The DLOG and DITL resources for a dialog box are created using ResEdit or 
some similar resource compiler. The resource numbers for the DLOG and DITL 
resources should be identical and should be between 1000 and 2000. Any item 
that you do not want to have the dialog return from if the user clicks the mouse 
on it should be disabled (such as editable and static text items). 


The DLOG resource should specify that the dialog is not visible and does not 
have a close box (no goAwayFlag). If you give the DLOG a ProcID of 0 (window 
with a title bar) the dialog box window can be dragged around the screen by the 
user. The below is a sample DLOG created with ResEdit. 
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Dialog ID = 1000 from Shell Test 


Window title: 


¡Sample Shell Window 


top bottom 


left right 482 
ProciD refCon 
resiD 


[ | Visible C] gohwayFlag 





Since this DLOG has a resource number of 1000, | would then create the dialog 
item list (DITL) resource with a resource number of 1000. As you add each item 
to the DITL resource, click on the Enabled radio control (shown in the 
illustration below) only if the item is of type pushbutton, radio control, checkbox, 
or special pushbutton (special pushbuttons are discussed later on in this 
chapter - ResEdit doesn't know anything about such an animal). Click in the 
Disabled radio control for any other type of item. A sample item definition 
dialog for a DITL resource is shown below (using ResEdit). 


Edit Item #12 


© Button O Enabled 
Q Check box (e) Disabled 
O Radio control 


O Editable text wo 
eft [14 —— 
O CNTL resource 


O ICON resource bottom 
© PICT resource right 18. o ooo 


O User item 


Static Text 21 





It's important to remember all of the information you type into each item 
definition, especially the item number (shown in the title bar) and the item type. 
Do not include CNTL resources or User items in your DITL resources. 


Once you've created your DLOG and DITL resources (and any ICON or PICT 
resources contained in the DITL resource), how does Red Ryder know how to 


Shell Compiler Documentation Pg. 4 


handle the user's interaction with the dialog box? It's done with a special 
resource type called SHEL. There is a special application on your master disk 
called Shell Compiler that will take a text file describing the items and create this 
resource for you. The compiler will first ask you to select the text file containing 
the item descriptions, and then to select the Procedure source code file to place 
the resulting SHEL resource into. 


Why does the Shell Compiler want to put the SHEL resource into the source 
code file rather than into the resulting compiled Procedure File? You are 
probably going to be doing a lot more development and fine tuning on the 
Procedure File source code than on the SHEL (and associated) resources, so at 
the conclusion of a compilation, the Procedure Compiler inside of Red Ryder will 
look to see if the Procedure source code file has any resources. if it does, the 
Procedure Compiler copies all of those resources into the compiled Procedure 
File. This turns out to be the most natural and least painless development cycle. 


One important note is that many text editors don't expect text files to have any 
resources. So if you use the "Save As..." menu choice in some editors to save a 
copy of a Procedure source code file, the SHEL, DLOG, and DITL resources 
may not be copied along with the text. If this is the case, you'll have to recompile 
the item list description with the Shell Compiler after the text file has been 

saved. The resources will also most likely be lost if you have to convert the text 
file into a word processor's format to edit it, and then back to text in order to 
compile it. That's why | suggest that you use a regular text editor (the 
RedWriter/MockWrite desk accessory is an excellent tool for this) rather than a 
word processor. 


Now let's describe the items description file that is submitted to the Shell 
Compiler to create the SHEL resource. 


The first line of the file is a SHELLID command in the format: 

SHELLID NUM_CON 

This command tells the Shell Compiler what resource ID number to give the 
SHEL resource. NUM_CON contains this number, which should be the same 
number as you gave forthe DLOG and DITL resource ID numbers. 


The second line of the file is an ITEMS command in the format: 
ITEMS NUM_CON 
NUM_CON is the number of items you will be describing after this command. 


Each item is then described with a DATA command which has the format: 


DATA NUM. CON1, NUM_CON2 , NUM_CON3, NUM_CON4, NUM_CONS, NUM. CONS , NUM_CON? 
The DATA commands must be listed in the order that items were added to the 
DITL resource. Therefore, the first DATA command after the ITEMS command 
must correspond to DITL item number one. Because of special pushbutton 


items, there may be more DATA statements than DITL items. We'll explain that 
in more detail later. 


After the last DATA statement, the command ENDSHELL (no parameters) is 
used to signal the compiler to go ahead and generate the SHEL resource. 


As you can see, there are seven numeric constants that must be provided with 
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each DATA command. What these numeric constants mean is different for 
each type of item, as follows. 


Pushbutton {tem 


NUM_CON 1: 
NUM_CON2 : 
NUM. CON3 : 
NUM_CON4 : 
NUM_CONS : 
NUM_CONG : 
NUM_CON?: 


NUM_CON 1: 
NUM_CON2: 
NUM_CON3: 
NUM_CONA4 : 
NUM_CONS : 
NUM. CONO : 
NUM_CON?: 


(zero) 
(zero) 
(zero? 
(zero? 
(zero) 
(zero) 
(zero? 


O OOOD OOO 


1 

checkbox 
0 (zero) 
O (zero) 
O (zero) 
O (zero) 
O (zero) 


number (1 to 20) 


Radio Control Li 


NUM_CON 1: 
NUM. COR2 : 
NUM. CON3 : 


in its 


NUM_CON4 : 
NUM_CONS : 
NUM_CONG: 
NUM_CON? : 


T 


NUM_CON 1: 
NUM_CON2: 
NUM_CON3: 
NUM_CON4: 
NUM_CONS: 
NUM_CON6 : 
NUM_CON?: 


2 

group number (1 to 20) 

member number (1 to number of radio controls 
group? 

O (zero? 

O (zero)? 

O (zero? 

O (zero) 


3 

string variable number (see below) 

CO if text is not selected, 1 if selected» 
O (zero) 

O (zero) 

O (zero? 

O (zero) 


Note: For NUM_CON2, A$ is string variable number 0, B$ is string variable #2, 
and so on up to Z$, which is string variable number 25. This variable is used to 
carry the item's text between the Procedure File and the dialog box upon entry 
and exit. If NUM_CONS is non-zero, the entire string will be highlighted in the 
dialog box (as if the user had drug his mouse across the entire string). This 
should be used only with one editable text item in the dialog. 


m 


NUM_CON 1: 
NUM_CON2: 
NUM_CONS: 
NUM_CON4: 
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O (zero) 
O (zero? 
O (zero) 
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NUM_CONS: O (zero) 
NUM_CONG: O (zero) 
NUM_CON?: O (zero) 


NUM_CON1: 5 

NUM_CON2: DITL item number this ¡tem is contained in. 
NUM_CON3: how item is to be tracked (0 = rectangle, 1 
= 15,15 round rectangle, 2 = 12,12 round 
rectangle, 3 = 16,16 round rectangle, 4 = oval 
or circle» 

NUM_CON4: left local coordinate of tracking rectangle 
NUM_CONS: top local coordinate of tracking rectangle 
NUM_CON6: right local coordinate of tracking rectangle 
NUM_CON?: bottom local coordinate of tracking 
rectangle 


Undefined Item 
NUM_CON1: 6 
NUM_CON2: O (zero) 
NUM_CON3: O (zero) 
NUM_CON4: O (zero) 
NUM_CONS: O (zero? 
NUM_CON6: O (zero) 
NUM_CON?: O (zero)? 


An undefined item is one that you wish Red Ryder to ignore. For instance if you 
have defined a static text item in the dialog box, but don't wish to have its text 
changed by a string variable when the dialog is displayed (as it would if you 

gave it a "Text Item" type), give it an "Undefined Item" type. This also goes for 
such things as icons or pictures which are not selectable. Just remember that all 
of the items in your dialog must be described in a DATA statement to the SHEL 
compiler, so if an item doesn't seem to fit any of the other Shell Compiler types, 
give it the "Undefined Item" type. 


An "Item Containing Special Pushbuttons" is used mainly for ICON and PICT 
items that you wish to define one or more areas inside (or the entire area of the 
item in the case of an icon or small PICT item) that acts as a “Pushbutton Item". 
In other words, your dialog box could contain a picture of a city street, with street 
signs or store signs that the user clicks inside of to navigate to other parts of the 
"city". Or you might have an icon of a telephone that the user clicks on to 
automatically connect to a remote service. So, if item number 5 in your DITL 
resource was an icon, you would supply it with the "Item Containing Special 
Pushbuttons" type to the Shell Compiler. 


After all of the DITL resource items have been listed in DATA statements, you 
then start listing DATA statements for the "pseudo-items" that we call "Special 
Pushbutton Item" types. It doesn't make any difference what order these are 
listed in, since in reality they are "real" items in the DITL resource. Each 
"Special Pushbutton" item's NUM CON? parameter tells Red Ryder which DITL 
item it is contained in. When Red Ryder detects that the mouse has been 
pressed inside of an item of type "Item Containing Special Pushbutton Items", it 
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goes through the list of Special Pushbutton Items belonging to that item to see if 
the mouse was clicked inside one of the "Special Pushbutton" item's tracking 
rectangles. lf that's true, the Special Push Item is "tracked" by graphically 
inverting it like a normal pushbutton. If the mouse button is released inside of 
one of these items, the dialog box is exited, returning the item number of the 
Special Pushbutton Item (not the item containing the Special Pushbutton Item). 


Remember that you must supply the tracking rectangle (NUM_CON4, 

NUM CONS, NUM CON6G, and NUM CON7) of a Special Pushbutton Item in 
the local coordinates of the dialog box window. A desk accessory such as 
Locator (available from CompuServe's Apple Developer Forum and many user 
groups) can be extremely helpful in determining these coordinates. The reason 
that there are three different types of round rectangles defined is that I've found 
that different "paint" programs use different preset values to determine the 
corner curvature of these rectangles. For testing, | used MacPaint, FullPaint, 
SuperPaint, and MacBillboard to generate round rectangles. 


Let's now demonstrate how all of the above muck fits together into a nice useful 
package. We're going to create a Procedure that sets certain parameters for a 
Hayes™ compatible modem. There are many more modem parameters we 
could play with than we will deal with here, but this should suffice for example. 
Specifically: 

1) Should the modem echo back the characters | type? 


2) Should the modem respond with verbal (words, like "CONNECT") responses 
or numeric (numbers, like "1")? 


3) Should the modem answer the the phone? If so, after how many rings? 


4) How many seconds should the modem wait after dialing for a connection 
before giving up? 


The first step, after defining what the dialog box should do, is to look at the 
nature of each of the these questions, and then decide what appropriate items 
should be used in the dialog box to obtain the answers to our questions. 


| would probably sketch out a sample dialog box like this: 
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C] Modem echoes typed characters < #3 
85 J "6 y 
O verbally © numerically 
88. 


O never sio, MT 


Oafter| | ri 3 





Notice how | put little reminders in my sketch as to the number of each item. 
Later, when | create the actual dialog box using ResEdit, I'll need to create each 
item in the exact same order. 


A table-type listing of the above sketch might look like this: 


ltem# Type Text Enabled/Disabled 
1 Pushbutton "OK" Enabled 
2 Pushbutton "Cancel" Enabled 
3 Checkbox "Modem echoes typed characters" Enabled 
4 Static Text "Modem responds” Disabled 
5 Radio Control "verbally" Enabled 
6 Radio Control "numerically" Enabled 
7 Static Text "Modem answers incoming calls" Disabled 
8 Radio Control "never" Enabled 
9 Radio Control "after" Enabled 
10 Editable Text (will be set on entry to the dialog box) Disabled 
11 Static Text "rings" Disabled 
12 Static Text "After dialing, wait" Disabled 
13 Editable Text (will be set on entry to the dialog box) Disabled 
14 Static Text "seconds for connection" Disabled 


After we write the Procedure source code, we'll use the above sketch and table 
to create the appropriate DLOG and DITL resources using ResEdit. 


First, let's write the input file for the Shell Compiler that describes the above 
dialog box. Examining our sketch, we see that we have one Checkbox. We can 
have up to 20 Checkboxes in a dialog box, and therefore could call this 
Checkbox any number from 1 to 20. We'll call it #1. 


Next, we see that we have two groups of Radio Controls, each having two 
members. Items #5 and #6 are members of one group, and Items #8 and #9 are 
members of a different group. Remember that we can have up to 20 groups of 
Radio Controls in our dialog box, and an unlimited number of members per 
group. We'll call the group containing Items #5 and #6 Group #1, and the group 
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containing Items #8 and #9 Group #2. Remember that we'll also have to refer to 
the member number in each group, so we'll do the following: 


Item #5 = Group #1, Member #1 
Item #6 = Group #1, Member #2 
Item #8 = Group #2, Member #1 
Item #9 = Group #2, Member #2 


The only other two items we'll need to keep track of are the Editable Text items. 
All we have to do here is assign a string variable that contains the string to be 
displayed in the Editable Text items when this dialog box is executed. 
Additionally, if the user modifies either Editable Text item, we can just look at the 
appropriate string variables after the dialog box is returned from to get their new 
contents. Note that we could have Static Text items whose contents are likewise 
changed upon entry to that of a string variable (of course, being static, the user 
could not modify them), but that wouldn't serve any purpose in our example, so 
we'll just call our Static Text items "undefined items" so that they'll be displayed, 
but ignored (that is, left to their original contents in the DITL resource). 


We'll link Editable Text item #10 to the A$ string variable, and item # 13 to the 
B$ string variable. Only one editable text item in a dialog box should have it's 
text selected (shown inverted), so we'll choose the topmost, item #10 for this. 


(Our DLOG & DITL resources for the dialog box will have resource ID's) 
Cof 1000) 

SHELLID 1000 

(I'm about to describe the 14 items in the dialog box in order) 

ITEMS 14 

(Note that the below DATA statements DO NOT contain the item number in) 
(the dialog box for each item. That is determined by the ORDER of each) 
(DATA statement! > 

(| tems #1 and #2 are simple Pushbutton items) 

DATA 0,0,0,0,0,0,0 

DATA 0,0,0,0,0,0,0 

(Item #3 is a Checkbox item, we call it Checkbox #1) 

DATA 1,1,0,0,0,0,0 

(Item $4 is an undefined item as far as Red Ryder is concerned) 

DATA 6,0,0,0,0,0,0 

(Item $5 is in Radio Control Group #1, and is member #1) 

DATA 2,1,1,0,0,0,0 

(Item #6 is in Radio Control Group #1, and is member #2) 

DATA 2,1,2,0,0,0,0 

(Item #7 is also Static Text we're leaving as undefined) 

DATA 6,0,0,0,0,0,0 

(Item $8 is in Radio Control Group $2, and is member #1) 

DATA 2,2,1,0,0,0,0 

(Item #9 is in Radio Control Group #2, and is member #2) 

DATA 2,2,2,0,0,0,0 

(Item #10 is Editable Text we'll link to the A$ string variable, and) 
(show with its entry text selected) 

DATA 3,0,1,0,0,0,0 

(Item #11 and #12 are both undefined Static Text items?) 

DATA 6,0,0,0,0,0,0 

DATA 6,0,0,0,0,0,0 

(item #13 is Editable Text linked to the B$ string variable, and does) 
(not have its text selected) 

DATA 3,1,0,0,0,0,0 

(Item #14 is undefined? 

DATA 6,0,0,0,0,0,0 

(The following command MUST be here to tell the Shell Compiler to stop) 
ENDSHELL 


Before we can run the above input file through the Shell Compiler, we need a 
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Procedure source code file to direct the output (the SHEL resource created by 
the Shell Compiler). The following Procedure should be typed into a text file, 
saved, but not yet compiled with Red Ryder. 


(Shell Demo Program, By Scott Watson? 

(First, we need to set up some defauits for our dialog box to show) 
(upon entry. Select the checkbox, and member #1 of both Radio Control) 
(groups. Set the first editable text item to "1" and the second) 

(to “30") 

SETBOX 1,1 

SETGROUP 1, 1 

SETGROUP 2, 1 

COPYINTO A$, 1 

COPYINTO B$, 30 

(That's all there is to it, let's run our dialog box with the resource) 
«ID of 1000, and return the item number the user clicked on to exit in) 
(the AR variable? 

SCREEN OFF 

(Now you know why there's a SCREEN command! > 

SHELL AZ, 1000 

(If the user clicked on the Cancel button (item #2) just get outta town) 
SCREEN ON 

TEST AZ = 2 

IF YES END 

(If we got here, we know he exited with the "OK" button, so go ahead) 
(and build the modem command string in Z$ based on the user's input.) 
COPVINTO Z$, AT 

GETBOX AZ, 1 

(Find out if Checkbox vas checked? 

TEST AR = 1 

IF VES CONCRT 2$,E1 

IF NO CONCAT Z$,EO 

(Find out which member of Radio Control Group #1 was selected) 
GETGROUP AZ, 1 

TEST AZ = 1 

IF VES CONCRT 2$,V1 

IF NO CONCRT Z$,UO 

CONCRT Z$,SO= 

(Find out which member of Radio Control Group #2 was selected) 
STRINGTONUM R$,B$ 

TEST B8 » 255 

IF VES LET EQUAL B£,255 

GETGROUP AR, 2 

TEST AZ = 1 

IF YES CONCAT Z$,0 

(This is a fancy way of validating his input. If he typed anything but) 
(a valid number into the Editable Text item, the follow two lines will) 
(make it zero.) 

IF NO NUMTOSTRING Bg, ñ$ 

IF NO CONCAT 2$,A$ 

(While we're at it, we'll validate his second Editable Text item too.) 
(However, since zero is not a valid number, we'll need to check and) 
Cadjust for that. > 

CONCAT 2$,S7= 

STRINGTONUM B$, Bs 

TEST BS = O 

IF VES LET EQUAL BZ, 1 

TEST Bg > 255 

IF VES LET EQUAL B&, 255 

NUMTOSTRING B£,B$ 

CONCRT Z$,B$ 

(Wowee! Now we should have a full modem command string. Let's do a) 
(couple of "AT" commands to make sure the modem is ready, and then spit?) 
(out our command string)? 

TYPE RT^M 

PAUSE 120 

TYPE RT^M 

PAUSE 120 
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TYPE Z$ 
TYPE ^M 
END 


Now, use the sketch and descriptive table we put together earlier to create a 
DLOG and DITL resource each having an ID# of 1000 in the Procedure Source 
code file. 


Finally, run the Shell Compiler, select the input file we created above, and then 
select the Procedure source code file to direct the output to. After the Shell 
Compiler is finished, you can then run Red Ryder, and then compile the 
Procedure source code to executable form. 


For your convenience, the input for the Shell Compiler is provided in the file 
"Shell Demo.inp", and the Procedure source code (containing the DITL, DLOG, 
and SHEL resources) is in the file "Shell Demo.src". The compiled Procedure is 
in "Shell Demo.PROC". 


As you'll see when you run this example, the "OK" button will be highlighted in 
the standard way to show that it is the default button if the user types a "Return" 
key. Red Ryder automatically highlights item #1 in your dialog box if itis a 
Pushbutton. 
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Flight Path Ladder 
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The Flight Path Ladder gives an electronic representa- 
tion of the F-16's angle of climb (or dive) at any point in 
time. The numbers go from 0 (straight and level) to 9 


(90° climb straight up); or in the opposite direction (with 


| | > ) negative numbers representing a dive) to -9 (90? dive 
| X ~ 7 straight down). For example, the Flight Path Ladder 
BE shown opposite illustrates a plane in a 38° climb. The 
| £ figure immediately below is another way of illustrating 
. what the numbers represent. 
90° 
7 2 9 8 , 


38° 


STRAIGHT UP 


PARALLELITO GROUND 


The Velocity Vector represents the degree of yaw and/ 
or pitch that your F-16 is incurring. You have an ability 
to point the plane in a line that varies from the general 
direction you are travelling. In the opposite example, 
the F-16 is flying straight and level (in fine with the 
velocity vector on an 80 degree heading), but the plane 
is pointed slightly to the right. You'll use this feature 
primarily in air-to-ground missions when you want to 





aim at a target without having to travel directly toward it. 


To point your plane in the manner of this example, you would hold down the *X “ëlom- 
mand) key while “pulling the stick right”. Your plane would point itself to the right while 


continuing to fly straight ahead. If you wanted to point the plane back to the left (completely 
lined up with your flight path again, if you want), you would hold down the "36 " key again 
and “pull left on the stick". When you perform these actions, you are "yawing right and 
left". 


"Pitching up and down “is the same theory applied to pointing the plane up and down 
while you fly straight ahead. The only difference is that you "push forward or pull back on 
the stick“ while you hold down the "38" key. For example, if you were going to fire at a 
ground target at low altitude, you might need to point (* "pitch" the he plane downward while 
you aim, so you wouldn't have to dive any further. 


If you need to realign your plane quickly, pressing the "K" key with the "3€ “ (Command) 
key automatically centers the yaw or pitch so the plane will be both pointing and iid in the 
same line again immediately. 





Represents any directional change that you make 
either in bank or pitch. Primarily designed as an aid 
for QuickStick and mouse users to orient themselves 
while changing direction, this indicator serves as an 
additional feedback for keyboard users as well. The 
Directional Indicator always represents where your 
plane's nose is pointing. 


Center Point 


Represents the exact center of each HUD type. The 
Center Point helps to focus your eye-hand coordina- 
tion when things get hot and heavy up there. 


Air-to-Air HUDs 


To select a particular Air-to-Air HUD mode (AIM-9J Missile, AIM-9L Missile, M61A1 Gun), 
tap the Air-to-Air Weapons Select key (Return) until your selection appears in the HUD 
glass. 


Note: HUDs for the AIM-9J and AIM-9L missiles are selected and displayed separately 
during the simulation since these missiles are operationally and physically different. 
However, the HUDs are functionally identical, so we'll discuss them together in one section. 
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fly below 20,00 Since it's optically guided, you need to gain a good sight on the target. 
Besides, long range SAMs (surface-to-air missiles) will be very happy to see you above 
20,000 ft, and you don't want that. 


Mk 84 2000!b Low Drag Bomb 





The Mk 84 (pronounced "Mark" 84) is a high quality, general purpose bomb. It is used for 
any air-to-ground bombing run where you want to make maximum impact. Bombs can be 
dropped from any altitude, but your accuracy increases dramatically as you fly closer to the 
ground, since you're relying on visual contact. 





Durandal Anti-Runway Bomb UNES ILIO 


The Durandal is a bomb that's especially destructive to airstrips. Whereas conventional 
bombs (like the Mk 84) create large craters where they hit, the Durandal drives itself into the 
airstrip, blowing a hole from under the pavement. This makes repairs much more difficult. 


Although you want to fly as close as possible to the ground o on bombing runs, don t move in 
below 2,000 feet or your bombs may eliminate you as well. 





ALQ-131 ECM Pod 





The ALQ-131 pod should be carried (if available) on air-to-ground missions. Itis an ECM 
(Electronic Counter Measure) device that emits signals to jam enemy radar, preventing 
SAM sites from getting missile lock on your F-16. 


Fuel Tanks 





Your F-16 has an automatic intemal fuel capacity that averages 6,950 pounds. You can 
add external 2,304 Ib. fuel tanks (up to three) if you wish to have added fuel capacity. Re- 
member that afterburner usage will eat up your fuel quickly, but don't get in the habit of 


p+ 


adding so much fuel (instead of armament) that you're flying a fat cow with no, “ction or 
maneuverability. 


ARMAMENT CONFIGURATION 





x R 


© Ò === O 


| ost ecu Poo @ 


ry C1 DURANDAL BOMBS 


MK 84 BOMBS @ e 


wu AGM-65B Tel Yee SO 
gt > CAPACITY (POUNDS) MAVERICKS x A 
250 250 2500 3500 2400 Me PEN 3500 2500 250 250 


90 9.0 Pa 5.5 55 55 9.0 9.0 


(9.0 if A -9L ONLY) (9.0 if AIM-9L ONLY) 


_ Note the numbers for CAPACITY and LOAD FACTOR. You are shown the total weight of 
your armament as selections are made via the Sarge. The LOAD FACTOR represents the 
highest amount of g's that you should pull if weapons are installed on that particular station. 
At the lower levels of the simulation, you will have few limitations on your armament. 
: However, at upper levels you must adhere to the rules for placing weapons onto the F-16. 
` When you select and load your armament at the beginning of the game, the Sarge - 
will alert you as to what configurations are possible or not. He will also place the weapons 

on your plane so that you maintain a symmetric (balanced) load. 
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(22 EJECT- ¿nal else falls, press the Option-E key combination to eject from your 
plane. Remember that ejection is not necessarily the safest or smartest option to take 
in a particular situation, and should be invoked only as a last resort. 


(28) JETTISON ALL STORES - If you fly into a predicament where you need to add some 
maneuverability to your plane, press the Option-K key combination to jettison 
everything except your missiles. We don't want you to be left totally defenseless! 


(29 JETTISON CENTERLINE STORES - You can separately jettison the ALQ-131 ECM 
Pod or any centerline-installed external fuel tank (Option-C), if you want added 
maneuverability or acceleration and need to get rid of excess weight. 


(80) BLACK BOX - If you are in a dogfight sequence and want to view an "instant replay" 


of the sequence so you can analyze the results, press the Option-B ke e 
invoke the BLACK BOX. i id 


G) YAW PITCH CONTROL - Use the "38" (Command) key in combination with the "Stick 
Control" directional keys to make fine tuning adjustments in your plane's PITCH and 
YAW. This allows the F-16 to point in different directions while travelling in an 
otherwise straight line. (See pages 60-61 for more info on YAW/PITCH CONTROL.) 


GÈ TRIM CONTROL - If you hold down the Shift key in combination with the "Stick 
Control" directional keys when banking left or right, diving, or climbing, the 
combination will produce a more gradual change in direction than would take place 
with the Stick Control keys alone. 


(83 ILS HUD - Press the " V" (Backslash) key to activate the Instrument Landing 
System (ILS) HUD, which is a special HUD mode designed just for landing purposes. 


(34) CENTER/LEVEL PLANE - Whenever you feel the plane is flying out of control, press 


the (') Apostrophe key to force the F-16 to resume a straight and level path. This 
feature is available at any rank. 


(89) SENSITIVITY - You can vary the F-16's sensitivity to banking, climbing, or diving tums 
on a scale from 0-9 with the " [ " (Left Bracket) [to decrease] and " ] " (Right 
Bracket) [to Increase] keys. For example, you might want to start leaming how to 
make bombing runs at "0" (zero) sensitivity, but end up progressing to "9" level 
eventually in aggressive dogfight battle. 


(89 CENTER YAWIPITCH - Pressing the °K" key (or "5" key on the numeric keypad) 
provides a quick way to bring your F-16's yaw or pitch back in center alignment, rather 


than making repetitive keypresses with the " 36 " (Command) key and the stick 
Control keys. 
"y 


— 


t You Have a Numeric Keypad B 


if you have a numeric keypad either as part of your main keyboard or installed separately, 
you can control the stick movement of your F-16 from here, along with other commonly 
invoked commands. This gives you a compact area for major function control and 
shortens reaction time. 


Clear - / * 
CLEAR A AA AG 
TARGET WEAPONS WEAPONS AFTER- 
LOCK SELECT SELECT BURNER 
Note: W you have the older style 
o numeric keypad that was sold 
8 t 9 separately by Apple (model # 
M0120), the command "locations" 
EN FORWAR AEN. are Identical to the layout shown 


here, although some of the keys 
are labeled differently. For 


š + 25 a 
m A 


4 5 5 example, the "+" (plus) key shown 
PULL CENTER PULL here for Throttle Increase is the 
<I sncx YAW! snck ^ *™ (comma) key Instead on your 
LEFT PITCH RIGHT worm pad. However, k performs the 
same function. 
Enter 
FLARES 


< = 
H 

gas N 
SER 


M you have a Macintosh Plus keyboard or later model from Apple, the amount and/or 
locations of the " 1” (Backslash), Option, and "36" (Command) keys may differ from 
these descriptions. However, they are functionally identical. 


Using the Mouse or a QuickStick 


Il you wish to use the mouse or a QuickStick for stick control, refer to the drawings on the 
following page and detailed information on pages 24-26. 


‘Note that if you use a QuickStick, you can use any of the joystick buttons as the Trigger. 
However, when using the mouse for stick control, the mouse button is used as an aid in 
dH rr that control, so continue to use the Space Bar as tho Trigger. 
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Keyboard Command Layout (Standard Mac 


QUIT TO MENU (21) 
THROTTLE 
ol 
D 
| 
Jik 


3 
= 
š 
E 
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OPTION-K 


CENTERLINE STORES) 


OPTION-C (JETTISON 





“Macintosh keyboard without a numeric keypad. However, if you have a keyboard with a 
“numeric keypad onboard (or a separate keypad), you have all the following functions plus 


‘several functions taking place on the numeric keypad, we have placed a special description 
of it at the end of this section. I you wish to use the mouse or QuickStick for stick control, 


Keyboard Command Descriptions ` 









“Note: These command descriptions and the facing layout are applicable to the older 








the option of running some of the commands from the keypad itself. Because there are 





(1) COCKPIT VIEWS - Press any of these keys (top row number keys only) to Change 
the view looking out of your cockpit: 
3- Front 
4- Lett 
5- Rear 
6- Right 
8- Autoview (If you press the "8" key, the view will automatically switch to the 
direction of an approaching plane, and subsequent passes by enemy planes will 
cause views to change automatically so as to follow the paths of the particular planes 
as they fly by. You can stop Autoview simply by selecting one of the other views.) 


(2) STICK CONTROLS 
“push forward on 









. Remember: Those with Macin-... 
tosh Plus or SE keyboards (ora: : 
Separate numeric keypad) have. 
_ the option of choosing between... 
the I-J-L-M setup and the numeric. 
keypad for stick controls. There : . 
.. are other duplicate functions... 
i. grouped around the numeric. -= 
keypad (for shorter reaction time) 
that may cause you to prefer that 
approach if you have a pad. See. 
the end of this section for añ in- 
depth look at the numeric keypad. . 


“pull right on 
the stick” 






eer [n 
the stick” “pull back on 


(3) THROTTLE - Press either "+" (plus) key to Increase engine throttle, reflected by an 
increase in RPM and (normally) airspeed. Press either *-* (minus) key to decrease 
throttle and RPM. 


You'l note that the *1" and "2" keys on the top row are also available for decreasing 
and increasing throttle, respectively. This is meant to accomodate both left-handed 
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usua" yil do a good job against the SA-6. Chaff is minimally effective, but that's better 
thani, ning. This missile (like the SA-2) is launched from SAM sites only, and is all too 
effective against low-flying and mid-altitude range aircraft. 


SA-7 Grail Missile 


Guidance: 
Range: 


Heat-Seeking 
6-7 Miles 


Max Speed: Mach 1.5 
Service Ceiling: 4,921 ft 


The SA-7 is a shoulder launch heat-seeking missile. These missiles were designed to be 
used against low-flying targets. The published service ceiling of the Grail is 4,921ft, but a 
Hunter in 1974 was hit at 11,500ft. The missile is not considered very lethal. Over half the 
A-4 Skyhawks in the Yom Kippur War that were hit by SA-7s returned to base. On the 
other hand, half of them didn't. 


Since any foot soldier can fire an SA-7, these missiles needn't be launched from a SAM 
site, so you can't see the ground locations where they come from. The best defense 
agalnst an SA-7 Is to fly above 10,000ft. A combination of flares and high speed Is 
also very effective. 


Avoiding SAMs 


Intelligence has done a good job of identifying (on the landscape map) the locations of all 
known SAM sites, where SA-2s and SA-6s are fired from. Foot soldiers are always on the 
move, so you won't know an SA-7 is in the area until you hear the launch and see the 
launch light (LNC) appear on your Threat Warning System. 


SA-2 and SA-6 


Carrying the ALQ-131 ECM (Electronic Countermeasure) Jamming Pod can greatly 

improve your chances against these SAMs. When activated and “emitting”, the ALQ-131 

completely jams SA-2 missiles to the point where they don't even Jaunch. The enemy may 
still launch an SA-6 in an attempt to burn through the jamming. 


Te only downside of using the ALQ-1 31 is that it broadcasts to the enemy that you’ re 





around. Expect to see some MiGs appear in the near future. 


Since SA-2 and SA-6 missiles are radar-guided, your 
Threat Waming System will pick up the specific site 
that launches one and display it as a small blip on the 
Threat Indicator at its location relative to your plane. 
(The site Itself projects the radar beam that the 
missile follows.) This blip is smaller than the one that É 


represents an enemy plane. REAT de) cus 


BERN Sonde BDA PS y em AAA A 





If you don't have an ALQ-131 pod, chaff combined with hard maneuvering q defeat the 
SAM. 


AVOIDING A SAM 





The first thing you must do during a SAM launch is visually spot the launch. Remember, 


look for an airborne object that resembles a telephone pole with flames coming out the rear, 
as it eaves the SAM site. Turn your plane toward the missile. Wait for the missile to begin 
leveling off. At this point, roll your plane upside down and pull several g's into a dive. Head 
directly toward the ground. At the same time, start releasing chaff. Continue to dive for 


- several seconds or until the SAM starts to dive. (You may have to look out the side or rear 


views to relocate the missile.) At this point, release some more chaff and pull back hard on 
the stick. Kick in the Afterburner and start a steep climb. Because of the small fins that 


. maneuver a SAM and its great speed, it can't tum with an F-16, and will eventually run out 


of gas. 


Another. way to avold SA-2's and SAS sis to fly low and close to the a. 





However, doing so makes you vulnerable lo SA-7 launches. 


SA-7 


Since these missiles are shoulder-launched, there's no SAM site to identify. The SA-7 
looks like a smaller version of the SA-2 or SA-6 when it’s in the air. They're not as lethal as 
the other SAMs, but they can shoot you down. Flying fast and launching flares are a 


WERE secondary defense against the SA-7. The best defense is to fly high (above 10,000 feet), 


beyond the SA-7's service ceiling. 


You can use the same alr-to-ground weapons against SAM sites that are used to 


_ attack other ground targets. Following are before and after close-up views of a 
- typical SAM site that gets destroyed by an AGM-658 Air-to-Ground Missile. 
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Indicator. If " ve's more than one MiG around, you can alternate between which one is 
“targeted” b, „essing the Air Target Select ("T") key. The Radar screen displays specific 
data on whichever MiG is “targeted”. When a MiG is behind you, you'll have to rely on the 
Threat Indicator and your own eyes (by looking out the different views) to determine its 
position. Radar can't detect anything to the sides or rear of your plane. 


Whenever possible, you want to maneuver your plane into position behind the MiG 
(commonly termed “moving in on his six", where the nose of the MiG represents 12 
o'clock on a clock face and the rear signifies 6 o'clock). It's certainly possible to hit the MiG 
with a head-on shot using well aimed AIM-9L's or gun bullets, but the law of averages 
favors the rear approach. When the MiG is in front of your plane but out of visual range, the 
Target Designator box will map the MiG's position onto the HUD. Continue to turn and 
maneuver the F-16 until youre in a favorable position relative to the MiG. 


Improving Missile Hit Rate 


Use the later model AIM-9L "All Aspect" Missile whenever possible. This model has three 
advantages over the older AIM-SJ. First, the AIM-9L can track an enemy plane regardless 
of the direction the target is facing. The AIM-9J requires that you fire at the rear of the 
target to provide an adequate heat source to track on. Second, the AIM-9L is less 
susceptible to being fooled by enemy flares. Third, the AIM-9L is more lethal. 


Don't fire missiles if you're too close to the target. An ideal minimum distance is two-thirds 
of a mile. Switch to the M-61 Gun when in tight, because anything closer than two-thirds of 
a mile may result in a miss from the Sidewinders. One cause would be the angular velocity 
of the plane relative to yours is too great and the missile is unable to turn fast enough. The 
other cause is that by the time the missile starts tracking, its target is out of position. 
Pulling lead (pronounced "leed") will improve the chances of a missile hit. 


Pulling Lead 


A common error made by inexperienced pilots is that they fire directly at their target. The 
problem with this approach is that by the time your missile starts tracking (about 2-3 
seconds after launch), the target will have already moved out of position. 


3 & Miss 
Door PE FLIGHT PATH OF MIG 
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Pulling lead is essential for proper guidance. It requires that you aim ahead off arget so 
that by the time the missile starts tracking, the plane will still be in position. Aim ar the front 
of the LCOS line (see page 63) to pull lead on your target. 


LINE OF SIGHT 





MISSILE HITS! 
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TRACKING 


1 
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A Sample Missile Launch MIG IS COMING OVER THE TOP 





REAR OF LCOS 
(DOTTED LINE) 
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FRONT OF LCOS 
(SOLID LINE) 








5 MISSILES, 


STANDING BY VULNERABILITY 
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SIDEWINDER 
IS ARMED TARGET IS FUEL LOW: 2 MINUTES 
LESS THAN ONE IN RANGE OF FLIGHT BEFORE 
MILE AWAY HAVING TO TURN BACK 


In this frame, the MiG is "coming over the top" of a climb. It's lost considerable energy in 
the climb, leaving it unable to make a “high g" maneuver (i.e., make a hard turn). Even 
though it's in range and within the outer Cone of Vulnerability, we hold off firing because of 
the angle and because we aren't “pulling lead". Note how the HUD alerts you when fuel is 
low. 
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The Lo "zer Deviation Scale displays the angle offset between the beam and your 
intercep. angle to the runway. The higher above the ILS beam you go, the lower the LD 
slides down the HUD, and vice versa. 
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HEADING 


P Lm" 


H4+23 Ñ ILS HUD 
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LS BEAM 
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TOO HIGH 


A perfect approach angle will show the GSD and LD coming together so that the middle of 
each scale crosses at the center point of the HUD to form a perfect cross. 


HEADING 
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ES 


ILS HUD 


ILS BEAM 





PERFECT APPROACH 


Its important to understand that your heading has nothing to do with where the GSD and - 
; LD are placed on the HUD. The ILS only checks for deviation between the current intercept 








, ofthe aircraft with required approach angle. That's why you still need to monitor the — 
heading scale during landing. Following is an example of a pilot who failed to monitor his 
heading. For a brief moment, the ILS appeared to be perfectly aligned, because the current 

aircraft position just happened to cross the ILS at the correct point. Notice how everything 
is aligned in the HUD, yet the heading is incorrect. = 









INCORRECT HEADING, YET SEEMS TO BE PERFECT INTERSECTION WITH ILS BEAM 


as 





* Continue your downward approach, making sure that the GSD and LD are tin 
alignment. Use small movements to make course and altitude correction. Du, t over- 
compensate. Once you've fallen below 5,000ft, throttle back to about 68% RPM and 
reduce your airspeed to 125-150 knots. Use the Air Brakes ("B" key) to help you 
decrease speed. However, make sure your airspeed doesn't fall below 100 knots. At 
higher ranks, falling below 100 knots can result in a stall, followed by a funeral. 





- At upper ranks, a correct Angle of Attack (AOA) is extremely important to the success of 
your landing. A plane's AOA should lie between 8 and 1 3 degrees (on the AOA Indicator). 
- Dropping airspeed will increase your AOA. Take a look at your AOA Indexer on the left ` 
Side of the HUD. If the top light is on, then you are coming in too steep and too slow. If 
the bottom light is on, then your airspeed is too fast and AOA is too shallow. A center 
. light indicates that your airspeed and AOA are perfect. (You'll learn more on how to ` 






4, , _ Control your AOA later.) |. 





» When you get below 4,000ft, drop your Landing Gear by pressing the "G" key. Your 
NWS System/Landing Gear Status indicator "RD Y" (ready) light should be illuminated 


. {just like it was before raising the gear earlier upon takeolf}. Check the Left View to make 


sure all three wheel lights are lit. 1f not, you better prepare for a crash landing (remember, 
upper ranks only). Here's a typical view at 3,500 ft: 


CORRECT HEADING 


NEED TO CORRECT A 


LITTLE TO THE LEFT GOOD ALTITUDE 





LANDING GEAR 
DOWN AND READY 





13 DEGREES 


* At this point, it's important that you monitor your altitude, alrspeed, GSD, and LD. Use 
throttle and alr brakes to adjust your speed. If you're going too slow, tum off your alr 
brakes and increase throttle, or drop your nose a little. (Don't get in the habit of 
dropping below 8 degrees AOA.) Use Trim Control (Shift key in conjunction with “stick” 
control) to make small adjustments in your climb angle and bank. Right before touching 
down (altitude under 100 ft), make sure that your climb angle (Flight Path Ladder. 
remember) is not less than -8 degrees. 
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: On jou've visually acquired your target (one of the three buildings), fly straight and ` + When the Bombsight reaches the base of the building, press your Trigger " ace Bar, or 


level heading directly toward it. When the base of the building touches the bottom of the 
HUD, begin a shallow dive of about 20 to 30 degrees toward the target so that the Aiming 
Reticle is slightly above the target. Your Bombsight may not be visible from this distance 
and dive angle, but you needn't worry. It's below the HUD. 
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+ As you move closer to your target, the Bombsight will begin to move up. Once you see 
the Bombsight, hit the Trigger (Space Bar; or QuickStick Button) once to clear the auto- 
matic sighting system. (This is used for pop-up, Of “fling” bombing, to be explained later.) 
Continue flying toward the target, making minor adjustments in bank and climb angle to 
keep the target in front of you. 


RETICLE ABOVE THE TARGET 
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Mk 84 (NUMBER OF NINE ALTITUDE 
REPRESENTS UNLIMITED 
saa u! En BOMBSIGHT NOT IN VIEW YET 
(CURRENTLY POSITIONED "BELOW" 
THE HUD, IN EFFECT) 
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QuickStick Button) again to release a pair of Mk 84 bombs. 
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BOMBSIGHT ON 
RELEASE POINT ALTITUDE 


- Pull back on your stick to execute a steep climb, so as to clear the debris area and avoid 
crashing into the ground. It'll take a few seconds for your bomb to reach the ground and 
detonate. You'll hear the explosion and an “X” will mark the location where your bomb hit. 
if you hit the target, the building image will appear damaged. Otherwise, you'll see a crater 
in the ground. Here's how a miss (schucks!) would look like out the Rear View: 
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When you try to pull up into a climb at upper ranks, you're going to need all the power you 
can muster to avoid stalling. Therefore, practice kicking in your Afterburner and rev the 
engine to 100% power. Remember: At First Lieutenant rank, you really don't “crash” 
. < even if you hit the ground. You're able to get back into the air. 
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. ifyo. ven't already done so, release your Wheel Brakes. (The WL BRK light should — CAUTION | 
be off. If not, press "W".) 


T lift off at sp e less than 1 Iti , talli 
« Next, hold the Throttle Increase key ("+") down until your engines have reached 100% iet | peeds less than 150 knots can result "— stalling, or "e 





MP Ss into the runway. 
l . , Note that the DISC (disconnect) light on the NWS System/LG Status Indicator illuminates 
* Continue to roll straight down the runway until your airspeed has reached 150 knots (15 nce your plane ser left the gr - = ans Sent io als ho landos x. : 
on the HUD Alrspeed Scale). You'll notice that the NWS System light (AR/NWS) will 
disengage once your speed has exceeded 90 knots. This means that you will no longer  , After takeoff. you need to retract land; š Er ; 
be able to steer your aircraft. ‚yo your landing gear by pressing the "G" key. Switch to the 


Left View ("4° key: top row). Look at the Landing Gear (LG) Indicator. All three tights 
should be off if you've successfully raised the landing gear. Switching back to the Front 
View (*3" key: top row), you'll also notice that all lights in the NWS System/LG Status 
Indicator tum off once the gear has been raised. 


150 KNOTS ` 


| NWS SYSTEM 
TAKEOFF SPEED 


DISENGAGED 






il 


ALL LIGHTS OFF 









For faster takeoffs and to compensate for heavier payloads, light your Afterburner for that. 
extra needed power (at the expense of using more fuel). Afterburner (AB) is engaged by : 
pressing the " / " (Slash) key. The AB light on the front panel will tum on. Non-afterburner 
takeoffs are called full military power takeoffs. The MIL indicator light will be | on instead of. 
(0.50; the AB light: on military power. takeoffs. ae x 










Faster Climb Rate 


* You should continue on an 8-12 degree climb angle until reaching 400 knots alrspeed. 
At this point you may increase the rate of climb. A climb angle of 30 to 40 degrees Is 
Ideal. Afterburner will also increase your climb rate. 






Don't allow your alrspeed to fall under 125 knots. There are four ways to increase your 
airspeed; increase throttle, light the afterbumer, dive, or reduce the rate of climb. - 





* When your airspeed reaches the takeoff speed of 150 knots, gently pull back on the : - ANN 
stick until you reach a climb angle of 8 to 12 degrees. As your plane leaves the ground, Moving into Position and Finding the Target 
the 10 degree step of the Flight Path Ladder on the HUD should cross the HUD center 


point, indicating a 10 degree climb angle. * Climb to an altitude of 25,000ft using a 30 degree climb at 450 knots. Your engine 


should be at 72% RPM (MiLjitary Power. "Level off" the plane by pushing the stick 


forward until your Flight Path Ladder crosses the center of the HUD at the 0 (zero) 
degree step. 


The most trustworthy navigational aid you have is your own pair of eyes. As you fly, look 
around at the different views. Try to identity natural and man-made landmarks such as 
mountain ranges, bridges, lakes, and buildings. 






10 DEGREE CLIMS UPON TAKEOFF 
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Kraft? ulckStick" 
SET SWITCH TO "J" (FOR JOYSTICK) 


“push forward 
on the stick” 


Bank (or Tum) — Joystick Bank (br Turn) 
Left 


Handle richt \ 


“pull right on 
the stick” 





“pull left on 
the stick” 


“pull back on the stick" 


Note: Either of the buttons on a 2-Button QuickStick can be used as the Trigger (for firing 
weapons), instead of the Space Bar. If you have a 3-Button model with an additional 
button on the handle, that button can be used as the Trigger also. 


IMPORTANT! 


The QuickStick must be set to “Joystick” operation (instead of “mouse”) on the slide 
switch, and placed In "spring-centered" mode. 


When you move the QuickStick handle to effect a change in any direction, let go of the 
handle and it will automatically center itself. In terms of the program, this operation allows 
you to make small changes in direction and maintain that change as a constant. In other 
words, if you want to make a small bank to the left, tap the handle to the left and let it return 
to center by itself. Every time you tap the handle in a specific direction, the plane will make 
a small directional change, and maintain that angle until you make another movement with 
the stick (all other things being equal). If you want to continue to increase the angle of turn, 
etc. in a specific direction, simply keep the handle held in that direction. When you let go of 
the handle, it will center itself as before and the plane will once again maintain a constant 
direction. (See page 61 for a discussion of the Directional Indicator in the HUD, which 
gives feedback on the directional change being made when you move the QuickStick 
handle. The Stick Centering Indicators (page 82) also give useful feedback on directional 
change when you're flying with a QuickStick.) 


—II-— 


\ Mouse 


Nose Down | 
fr li 0 "push forward 


on the stick" 





"pull left on 
the stick" 
Bank (or Tum) Bank (or Turn) 
Left À 
"pull right on 
the stick” 
“pull beck on the M A y 


Nose Up 


Sliding the mouse in a particular direction to change the pitch or bank of your plane is not 
so different from using the keyboard or QuickStick. When you slide the mouse to effect a 
change in any direction, the plane responds by changing its direction until you stop sliding 
the mouse, which “centers the stick”. When the mouse stops moving and the "stick" is 
therefore "centered", your plane continues on the same path until the mouse is moved 
again. 


Tre challenge of designing a mouse interface for FALCON was ‘two-fold, The mouse isa 
very dynamic and sensitive device, while the F-16 is an incredibly quick and maneuverable 
B fighter. We could have made It fallsafe and very easy to keep under control, but 
performance would have suffered and you wouldn't have been flying an F- 16. 












An effective compromise turned out to be allowing you to control the sensitivity to change, 
by the way you move the mouse. 


Without holding the mouse button down: 


« Move the mouse slightly and slowly to effect small changes In direction. Remem- 
ber, every time the mouse stops moving, you "center the stick". 


° Slide the mouse faster and over a longer distance to cause larger and more 
accelerated changes In direction. 
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° Direct! \demeath the HUD glass is a combination Radar/Map screen, called the 
COMED ,ombined Map/Electronic Display). It will be the second most-watched item in 
your Cockpit after the HUD. In Radar mode, it monitors details like the horizon and relative 
2osition of enemy planes to yours. In Map mode, it shows your current location in the 

r ALCON world, along with landmarks to guide you during missions. Press the *C" key to 
toggle between Radar and Map. The default selection is Radar. 
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YOU ARE HERE 


RADAR MODE MAP MODE 


* The Military Power/Afterburner Indicator shows whether you are currently invoking the 
engine's Afterburner (AB) for extra acceleration, or if you're using standard Military Power 
(MIL), which is a term for normal engine usage and acceleration. Press the ° / " (Slash) key 
lo toggle between the two settings. The default setting is MIL. 





» The Attitude Director Indicator (ADI) aids in orienting your plane to the horizon while 
pitching and rolling. Use it in combination with the “waterline” (your plane's position parallel 
fo the horizon) and visual contact with the real horizon to orient the plane directionally. 








p 


ADI WATERLINE 


VISUAL HORIZON 


ge Ver 





* The RPM Gauge represents the percentage 
(%) of power that has been applied with the 
Throttle ("+") key. (This example shows just 
over 70% of power being applied.) 






* The Stick Centering indicators help in 
orienting your plane's direction when you're 
using a QuickStick or the mouse for stick 
(directional) control. 





* The Wheel Brakes light is on, signifying that |] E BOCH 
your wheel brakes are set. This keeps the [Meses š 
plane from rolling when the engine is started. 





III: li: 


Before taking off, take a look out the other views from your cockpit, specifically the Left 
View ("4" key-top row) and Right View ("6" key-top row). You'll leam more about the 
additional gauges and panels later. For now, you might note the initial com pass heading in 
the Left View (due north) and how it matches up to the degree heading in the HUD and 
your current location on the COMED Map mode. These indicators can help you find your 
way back to the landing strip if you're lost or retuming home from a mission that takes place 
a long distance away. 
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About the Milk Run 


The objective of the Milk Run mission is to destroy one or more of the buildings located 5 
miles east of your home base. 








'eseq awoy JnoÁ jo ¡sea sapu 
ç poje20| sDuipiinq ayy jo ƏJotu 30 euo Aonsəp oj sj uoissiu UNE xr eut jo eumefqo OU) 


ung xir 843 1noqv 





—  — — s ws w eee ce sac “ass 






) TO 00 st ye 


E^ | ws... soans 
mee “ass i ii 


"heme eouejsip uo] e 
eoe|d Saye] Jeu] UOISSIWW e wos aurou uuna 10 50] e/o ji duis Duipue; eu 0) xoeq Aem 
INOA puy NOA djeu ue» sjojeoipur SAY “apow dew AJANOO AY uo uoneoo| Juano moÁ 
pue GNH eui ui Duipeeu eajDep ayı oj dn sayojew y moy pue (YOU anp) mala ya] eu 

ui Buipeau sseduioo penu au ajou 1uBitu noÁ ‘mou 404 “18]e] Sjeued pue sabneb jeuonippe 
OY) jnoqe aow wea] noA, “(mal Go}-ASy ,9.) AƏJA Judiy pue (mos dor-Áo , p.) MAJA 

ue eu  Ajeogioeds "jidyooo snoA woy sman JƏulo AL INO x00 e exe] ‘yo Dune] eojog 


‘paes si euibua eu ueuw Burro wo aueıd 
Gu} sdeaX SIU] 19s 819 SIJL ¡ISLA JnoÁ 
yey) BurAyubis ‘uo si jut sexe1g PIM OUL + 


c SIMI 





"10109 ([Puonoeup) 

YONS 104 BSNOW SUI JO xor Syon e usn 
a, noA USUM uongoeJip S,Buerd nok BuljuaO 
u! dieu suoyeojpuy Bujiazua) NS eu, « 





(pandde Gureq samod jo %02 J8A0 

jsn! smoys ejydurexe siu 1) “Ady („+.) emouu, 
aup ui^ padde uəəq seu reu] amod jo (%) 
ebejuaosed eui sjuesaudas eBnes Wd eu) + 








Eon. cn ón 


NOZIHOH IWASIA 


3NI1831VM Iv 






Limos bee das . 


“Ayeuogoe.ip sued ay juauo 0) uozuot [L31 eui ur 196]u09 [ensi pue (uozuotu aui 0) 
|ayesed uonsod s,euejd noA) ,euijajeM, eut LIM uogeuiquioo ur y asn "Duo pue Durqoud 
9jIuM uozuou eui 0} ued JnoÁ Dunueuo ur spre (iav) 1O1e9Ipul 10193110 epnimy eu + 





“TIN S! uMƏS ynejap eu; "sDunjes o ap uaamyaq 31660) ol 

Aay (yseis) . / . 9u) sse1d "uomeJejeooe pue eDesn euibue pevou JO} uua] e SI uou 'CTUN) 
Jewod eyy puepueys Duisn e/noÁ ji 20 ‘uoyesaja00e exa 10; (gy) saunquayy s,aulbue 
eu] uoau; Ajue.uno ase noÁ JAPIM SMOUS Jojeaipu Jeuanqueg v 4eMog few eu. - 


3d3H IHY NOA er 





"JEPEH SI uodoejes IInEjap eq; "dej pue epey usamjaq abbo 

0} Aay „9, 94 SsaJd `suotssiu; Duunp Nod epinb oj syewpuR] uti uoe ‘PLOM NOD TY" 
ay] ui UOIT2D0; que.uno UNOA SMOUS y *epou deyy ul ‘sunod oj seuejd Awaua jo LONSCXK. 
8411819, pue UOZWOL BL] exi SHEJEP SJQlluou: 1 ‘POW JBPEY U| “CNH SU) JAHL idyooo JnoÁ 
ul way peuoyew-1sou puooes eui eq uw j| “(Aejdsig oiuoie[a/dew peuiquie^" QIWO. 


"En PONLI “uee;os deyyrepey uogeuuioo e sI sseió ANH eq ureeuep. AIO ° 





m Š " 
y = s 
Š š gs ES 
2 "EE : z ES 
ul = 0 = 
£ ¿5282 b z Š 
2 ween t = 
= ¡283% o pee Š 
-— 5 QE B Š 
o 3 m E = 
V q w E MES 
3 5 E b= Et 
Sic i58 EE 
Q) O : x u e ] e 
u. š — F x 
t- , x tr ea 
< £ J; Nd o on. 8 | x s < 
S š E ti 
9 : EEE TR = OR — 
= g : oa A J» [A Š 
a * x Er Š 
< E E < š 
S x : E 3 i 
š E š 
Q Š 5 AN < < 
as HI ul 
E i 5 
O 3 i : 
-] = > 
<x ec 3 
LL. x < To \ 
Q 58 £8 
C ón 2 z 
= s Š Us u EN z 
2 2 a SGSI = 
= Ë p = : O 
< = o 9:0 = 
e «t o 
> a E 2 
" p 5 
E 2 " 
* š 
P d 


Cockpit Orientation | 


After the Sarge signs off, the next screen has you seated in the FALCON, ready for takeoff. 
Your plane is resting on Runway # 36. 


Take some time to get familiar with your F-16. Inside the plane, you are facing the front of 
the cockpit, which contains the most important displays and controls to be used in the 
simulation. Look at the components of the cockpit, and compare them to the iliustrations in 
your Flight Manual and foldout reference sheet. You don't need to know what every item 
represents just now, since all the F-16's characteristics aren't activated at First Lieutenant 
rank. (All cockpit features are discussed in detail in Part 1 of the Flight Manual.) 


Now, let's discuss the ones you do need to watch on your first flight. 


* The most prominent feature of the cockpit is the Head-Up Display, or HUD, which is 
located in the upper middle of the screen. The HUD is a piece of glass (separate from the 
canopy) upon which important data is displayed electronically. By having vital information 
displayed directly in front of your eyes, you don’t have to look around the cockpit as much, 
which helps to maintain your concentration in battle. Although there are several different 
HUD types, it starts off in "Alr-to-Air" Mode and displays essential items such as airspeed, 
heading, gravity forces, altitude, and the flight path ladder. 


HEADING SCALE (IN TENS OF DEGREES) 






ALTITUDE SCALE 
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HEAD-UP DISPLAY (HUD) IN "AIR-TO-AIR" MODE 
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After yr" "`e selected a name for the DUTY ROSTER, the next screen allows you to select 
the lev... difficulty at which you will fly, along with the specific objective. 


P 


é File ALM scene Controt Options Rh 





SBS 


RANK 


Select from a listed rank to determine the difficulty level. The order is from First 
Lieutenant (easiest) all the way to Colonel (highest difficulty). (Note: Part Ill of the manual 
discusses the differences between ranks, plus how they affect your plane's performance 
and that of the enemy.) You select a rank by simply moving the arrow cursor over the 
desired rank box and clicking the mouse or QuickStick button. 





"Leave the selection at tst (First) Lieutenant for your Initia fight. 
MISSIONS 





This is where you choose from any of twelve different missions involving air-to-air combat, 
air-to-ground strikes, or a lot of both! There Is a ribbon to the left of each mission name, 
which will be awarded to you If the mission Is completed successfully. (Note: Part Ii 
of the manual describes details of the different missions.) Just like rank, you select a 
mission by moving the arrow cursor over the desired mission box and clicking the mouse or 
QuickStick button. 





MAXIMUM NUMBER OF MiGS 


You can choose between zero, one, two, or three as the total number of enemy MiG-21 
planes (within rank and mission limits) possible to be onscreen at any particular time. 


= = s= = = = 


y 


Program speed degradation may occur with more than one plane onscreen 
pending on your hardware. We recommend the following guidelines: 


1 time, de- 


+ Macintosh 512 or 512E (w/1meg of RAM or above): only one MIG 
« Standard Macintosh Plus: one or two MIGs 

¢ Standard Macintosh SE: two MiGs OK 

* Any Macintosh with a 68020 accelerator card: three MiGs OK 


These are only guidelines and you may vary from them if you feel the performance is 
satisfactory. You select the total number by moving the arrow cursor over the MIG 
Selection box, and clicking the mouse or QuickStick button until the desired number 
of plane Images appear (or disappear, as It were, if you want zero planes). 


: There are no MiGs on the Milk Run mission (if you stay in the mission area, that is). 
con Simply accept the default selection, which is the image of one plane. 






« After you're finished making selections on this screen, move the arrow cursor over to the 
ARMAMENT box and click. 


Armament Selection 


r 


nm 2504 bi WE Atl set end good luck. 










‘Because you're flying at First Lieutenant level for the first flight, you have unlimited 
armament available. Therefore, you won't make any choices from the Armament ` 
Sy selection screen like you would at other ranks. —— —— o 









Even so, take a look at the Armament selection screen and read the following information 
just to get familiar with the procedure for future use. 


d 
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Setup and Loading Instructions 


it is assumed that you are familiar with basic terms and operations of the Macintosh. These 
include pointing and selecting with the mouse, and choosing commands from pull down 
menus. If this is the first program you have run on your Macintosh, refer to the Macintosh 
Owner's Manual to become familiar with how to operate your computer. 


Making a Backup Copy of the FALCON Disks 


The FALCON program is provided on two disks, labeled Disk 1 and Disk 2. You should 
immediately make a backup copy of both disks and use the backup set for everyday 
operation. Follow the normal Macintosh conventions for copying disks, but make sure your 
orlginal disks are locked (i.e., the write-protect tab has been set) before you make the 
backup, so you don't accidentally erase the original FALCON disks. 


IMPORTANT! 


` {tis very important that the backup disks be named "FALCON 1° and "FALCON 2°, 
- respectively, just like the originals. Don? forget the space between FALCON and each 
number! The program is set up to ask for the disks by those specific names. Also, make 
Sure you don't change any of the file names, and don't create a folder on either disk for the 
purpose of segregating files. All the FALCON files must remain on the top level together, 










| Et | and not nested in separate folders. . "TET 





If you wish to run FALCON trom a hard drive, create a folder on your hard drive called 
"FALCON", and copy all the files from Disk 1 and Disk 2 (except System and Finder) into 
that folder. ALL THE PROGRAM FILES MUST RESIDE IN A SINGLE FOLDER (except 
System and Finder, of course). 


Using a Kraft QuickStick 


if you're going to use a QuickStick, make sure that you have it plugged in before turning 
your computer on. The QuickStick must be set to "joystick" mode. 


Loading the Program 


Note: FALCON will auto-boot if you power up (or "Restart" with your backup Disk 1 in the 
internal drive. It is possible to load FALCON (via the "Start FALCON" Icon on Disk 1) from 
the Finder, and the following instructions will assume that is the way you are loading the 
program. However, because of the problems that can be caused by certain previously- 
loaded programs that leave traces of themselves behind, we recommend that you always 
"shut down" before entering the game. 


_ The Same recommendation applies after you've finished playing FALCO” You 


should "restart" or "shut down" before using another application. 
All Macintosh Models: 


(1) Turn on your Macintosh. 








If you have a Macintosh with one floppy drive: 


(2) Insert your backup Disk 1 into the internal drive. 


(3) Double-click the Start FALCON icon. A short time will pass as the FALCON title 
screen and theme music are loaded. After the title screen appears, the music will begin to 
play, just to get you in the mood for a little fighter combat. Along with the music, you get a 
sample of some of the weapon and jet sounds that will be heard during the game. In the 
future, you can click the mouse at any time after the title screen appears if you want to 
bypass the music. After the music stops, follow the alert box prompts to exchange your 
backup Disk 1 with backup Disk 2 as the program loads the necessary data. 


IMPORTANT! You need to leave the backup Disk 2 In the internal drive for the 
duration of play, because information may need to be accessed from or written to it. 
As was stated in the Hardware Requirements, don't set the write-protect tab on your 
backup Disk 2. The program will crash when a write attempt is made, if the write- 
protect tab has been set. Your only solution will be to restart. 


Proceed to (4) below. 








If you have a Macintosh with two floppy drives: 


(2) Insert your backup Disk 1 into "Drive 1" (the only internal drive if you have a Macintosh 
512E or Plus; the lower drive if you have a Macintosh SE with two internal floppy drives) 
and place backup Disk 2 into the second floppy drive. 


(3) Double-click the Start FALCON icon on your backup Disk 1. A short time will pass as 
the FALCON title screen and theme music are loaded. After the title screen appears, the 
music will begin to play, just to get you in the mood for a little fighter combat. Along with the 
music, you get a sample of some of the weapon and jet sounds that will be heard during the 
game. In the future, you can click the mouse at any time after the title screen appears if 
you want to bypass the music. 


Á . 
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Intro. uction 





Our hopes, like towering falcons, aim 
At objects in an airy height; 

The little pleasure of the game 
Is from afar to view the flight. 


Matthew Prior 
In the wild, the falcon is the most effective predator for its size compa | any other. 
While many birds hunt for their prey noctumally, the falcon searches only eh oe day, 
being an aggressive natural hunter. It is considered to be equally as effective at hting in 
the air as striking a target on the ground. ve 


This natural inspiration spurred development of the most versatile jet fighter in the air today, 
the F-16A Fighting Falcon from General Dynamics. 


FALCON was designed to be a highly realistic simulation of the F-16, yet you have the 
opportunity to fly this powerful jet with tremendous ease. As you progress in flying skill, the 
ability to take over more control of FALCON's detailed F-16 features will strongly test your 
mastery of flying in air combat, and provide many hours of enjoyment. 


About This Manual 


Fighter pilots have to spend much of their lives leaming everything there is to know about 
their airplanes, along with understanding the enemy's planes and pilots they may go up 
against in battle. A considerable time will pass in training before they even take a seat in a 
fighter jet. We obviously don't plan to put you through such rigorous training just so you 
can fly FALCON. However, in such a thorough simulation, there is a great deal to learn 
over the course of playing FALCON that will determine how well you perform, especially at 
the upper levels. 


Therefore, in Part | of the manual, we're going to send you for a test flight at the lowest 
level of the program. This will enable you to get a feel for the basics of flying the F-16. Most 
of the plane's true characteristics will be toned down a bit, and it will be impossible to crash 
or be shot down. 


After you've gone for a few introductory flights and are feeling pretty comfortable, read Part 
ft of the manual to leam all the commands available to you while flying the FALCON, along 
with a few hints about what to expect while flying at the higher levels of the program. We 
cover some of the basics that one has to leam in order to be trained as a real fighter pilot. 





FALCON presents game difficulty levels according to a military pilot's rank. Part lll covers 
the different ranks that you'll be striving to perform at, from First Lieutenant Ë way to 
Colonel, This section also covers the variety of air-to-air combat and ground strike missions 
that you can select from. 


Part IV moves deeper into the strategy and tactics involved in air combat, including 
maneuvers that the enemy MiG’s will be performing as they engage you in dogfights. 
Learning how to perform some basic maneuvers yourself will help your performance at 
upper levels of the simulation. 


We have purposely designed the lower levels of the program to be relatively easy to 
perform, so you can gradually develop the skills necessary to enter combat at higher ranks. 
If you're familiar with how jet fighters like the F-16 operate, either through reading or the 
play of other computer simulations (Maybe you're a real fighter jock!), you may be tempted 
to skim over the manual and dive into the upper levels of the simulation. Be forewarned 
though, at the Colone! level of FALCON, the simulation is very faithful to the operation of 
the real F-16, and the MiG's you will be battling are close to invincible. 


We recommend that you fly at the lower ranks until you have a firm grasp of the plane's 
characteristics and the nature of air battle. Then you can attempt to rise in rank and fly an 
increasingly more realistic F-16 against more formidable opponents. 


It goes without saying that we want you to have fun playing with FALCON. We certainly 
have! At the same time, we hope we've given you an opportunity to leam a little about an 
exciting, important subject. And maybe you'll discover, as we did, a newfound respect for 
the pilots who fly these planes every day in the service of their counties. 
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The F-16 Fighter Simulation 


Good airplanes are more important than superiority in numbers. 


Air Vice-Marshal J.E. "Johnnie" Johnson, RAF 
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visual sightir,, system. Phase 2 is the approach. This is where you level off and approach 
the target. Phase 3 is the climb and release phase of the bombing. Pop-up bombing is 
effective at altitudes between 2,000 and 10,000 feet. 
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Discretes | 


The Discretes on the Bomb HUD indicate the status of your 
bombing. ARM means that your bombs are armed. LOCK 
means that the target has been acquired and that your trigger is 
"pickled" (bombs ready to be released). REL signifies that 
bombs have been released. 


HUD Mode Indicator 


This tells you that the bombs you are selecting are either the Mk 
84 2000Ib Low Drag Bombs (MK 84) or the Durandal Anti- 
Runway Bombs (DUR). 


Bombs Remaining 


This figure indicates the number of bombs onboard of the 
selected type. Bombs are loaded and released in pairs (except 
at First Lieutenant level, where you have an unlimited number 
of bombs). 


Target Designator 


indicates the target your radar is tracking. You use the Air-to- 
Ground Reticle to aim at the target, and when you press the 
Trigger a first time to "pickle" the target, a Target Designator 
appears in the aimed area. It will follow the target up until bomb 
impact or until you have completely passed over the target. 


—RI Air-to-Ground Reticle 


The A-G Reticle is the device you use to align with a target for a 
lock-on. This form of Reticle is "fixed" on the HUD centerpoint 
for ease in aiming. 


= In Range Indicator 
IN ANG 41 


| MK 84 | 


[A] 


The In Range discrete (IN ANG) will appear when you are in 
bombing range of a target. 
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Air-to-G. Jund Missile HUD (AGM-65B MAVERICK) 


The AGM-65B Missile is designed to be visually locked-on to a ground target by the pilot. 
In the front end of each Maverick missile is a TV camera with a zoom Jens. The television 
image is fed to the pilot through the COMED. This allows you to acquire your target 
electronically from distances beyond visual range. 


HUD 


COMED 





uw 


LINE OF SIGHT 
THRU RETICLE 





Discretes 


The discretes on the AGM-65 HUD describe whether or not your 
missiles are ARMed, LOCKed-on, in range of a target (IN 
RNG), or RELeased. If no message appears, it means that 
there is something wrong with the system or that you are out of 
missiles. 








T LOCK” mo] 


AGM 65 HUD Mode Indicator 


haran»: 
1 


indicit! c Prius Lo a Cot ae Py nra e 


Displays AGM 65 to indicate you're in Air-to-Ground Missile 
HUD mode. 


Number of Missiles 


The number following the M indicates the total number of AGM- 
658 Missiles you have onboard. 


Air-to-Ground Reticle 
Use the "fixed" A-G Reticle to align with a target for a lock-on. 


Target Designator 





Appears when you press the Trigger a first time to lock-on to a 
target. It will stay locked-on to the target until you pass the 


target. 
Distance to Target 


Once you have locked-on to a target, the distance to the target 
{in feet) will appear in the bottom right HUD area as you close in 
on your objective. Altitude is considered in the distance 
computation. 





HOW TO FIRE A MAVERICK 









. Select the Air-to-Ground Missile HUD mode by pressing the A-G Weapons Select key - 
. (Backspace) untii AGM 65 appears on the HUD Mode Indicator line of the HUD. Next 
you need to make sure that you're in Radar mode on the COMED so that you can view a 

targat through the inicia zoom lens. If you're still in Map mode, Switch to Radar mode 

d "EM -by toggling the COMED with the °C’ key. uo 
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Flare Indicator 


Your F-16 is equipped with flares which are designed to foot heat-seeking 
missiles. The Flare Indicator tells you how many flares you have remaining 
on the plane. You start with 30 flares onboard at the beginning of each 
flight. 


Stores Cool Panel 


This cockpit panel displays the conditions inherent with the currently selected weapons 
Mains HUD mode. in the sample below, the Air-to-Air HUD is selected, radar (APG- 
66) and LCOS are turned on, and AIM-9J missiles are activated and ready. 














. Shoot off flares by pressing t (tide) key. it's very important that you don't release 
your flares too soon, in order to properly force the incoming missile to seek the flare instead 
of your exhaust pipe. Heat-seeking missiles are almost always used at close range. Re- 
member, if your Threat Warning light shows a “LOCK ON" (enemy missile lock-on) warning 
before the “LAUNCH” (enemy missile launch) light appears, the enemy plane has fired a 
radar-guided missile at your F-16, and flares won't do any good. Be generous with flares! 
It won't make any difference if you have flares remaining when a missile flies Up your 
.. Six!!! (P.S. Heat-seeking missiles especially like planes with afterbumers flaring.) — 
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in FALCON, one way to see all the weapons stores currently on your plane would be fo 
toggle through all the HUD modes. A more efficient way to do this is by pressing the v 
key. You will see all the weapons listed on the Stores Control Panel without having to exit 
the current HUD mode. In this manner, you can monitor all the weapons you have 
remaining at any time, something which must be done quickly in the heat of battle. 


Chaff Indicator 

Chaff are packages of tiny foil strips which confuse radar-guided missiles. 
The Chaff indicator shows how much chaff you have remaining on the plane. 
Your F-16 starts with 30 packages of chaff aboard at the beginning of the 
game. 








Eng ine Fire Li g ht You can dispense Chaff by pressing the "Tab" key. Chaff has no effect on heat-seeking — 


.. missiles, so only use it when the “LOCK ON” light has flashed on the Threat Warning ` 
System before the "LAUNCH" light appears. Missiles that are fired from distances greater 
than seven miles are almost always radar-guided. The same generosity principle discussed 
KDE <. in flare usage applies here as well. — 






You may encounter an engine fire during battle if the enemy 
bullets are well placed. When this light comes on, your only 
choice is to eject from the plane. Refer to the Ejection 
Handle paragraph following for more information. 


Jet Fuel System Start Light 














ECM (EMIT) Indicator 
The ECM (EMIT) Indicator registers the use of ECM (Electronic Counter- 


"" | "TE Ee T ging Measures) which is employed via the ALQ-131 Pod (and the "E" key) 
This fight will tum on when the engine is started. Most of AM GEM installed on the bottom of your F-16 to foil ground-based SAM (Surface-to- 
the time, you will only be aware of this light for a ie iE Air Missile) siles. Emissions can also be used on MiG planes which have 
on the ground before increasing your engine to takeo S MN NETS radar-guided missile lock on you. This confuses their radar. The problem 





speed. Occasionally however, if you incur a severe stall 
while in the air, you may have to restart the engine . 


When starting up your engine at the beginning of the game, press either "+" key to initiate 
JFS Start. The engine RPM will increase until it reaches 60 percent, when the Jet Fuel ` 
System Start light will go out, and the main engine throttle control will take over. If you 
suffer a rare engine shutdown due to a severe stall in the air, you'll know by looking at the 
RPM gauge, where the needle will have dropped to zero. If the sound is toggled on, youh 
hear the engine die. The best way to restart the engines in the air is to press either $ 
(plus) key while in a controlled dive, and level out once the engine is throttled up again. 


with using ALQ-131 emissions is that it announces to the world that you're 
coming. Therefore, you should use it only after being acquired by an enemy 
plane or SAM site. By definition, ECM includes the Threat Warming System, 
Chaff, and the above-mentioned ALQ-131 Pod, so you may hear it dis- 
cussed as it relates to each of the different systems. 
















ff you're going to fly a mission that involves being around SAM Sites, you should request an 
ALQ-131 ECM Pod from the crew chief during the Armament screen sequence. 








LLL uwa 





SLUOISSI[/J 
pue syuey Kenny “111 ded 


“e 





"Aensıa pasnboe 

eq 0) arey ABW SHIN Áujeue eui JO eulos uau '|ƏAƏ[ [BUOIO4 JE J! Jo Ə5PJUPADE 
exei ÁIQEQUId ji noÁ pue ‘suoRoavip je u! Ayıgısia juejeoxe SMOJE lidyo0o2 
91-3 SUL "Mala 388) ay] 0] eDueuo o] mos preogÁay dol ayy uo Ka .S, eu ssaid 





MalA 189Y 
CA hehe de de de deded. 


‘1843 pue Jybreus Buky ji uaaa ino x9e¡q oj ureueo 81,10% Jo 189) 000'22 
anoge Ay Luod `əlou Jaınq e Aq pesneo Ayensn 'eunsseJd uqes ui dosp e sajeorpul 


MOT AXO 


'UMOUS JOU S! uogisod aapea INOA Ing 'uaa:2s GIWON eui uo 
pəÁedsıp eq ım pub dew ey, “Apadosd Buiuogouny jou s! dey noA Jer] sejeorpul 


AVN 


‘Aessadau ji joala o) e:&deud pue ‘Ajaye 
-|peuiui BUOY 30) peau 'Ápioinb dop o) suejs abneó noA yy wea eur jo Ájuaaas 
eu Jojuou oj Ájssop? eDnec) jon ey ue “wajsÁs ¡any ey] u! YLA e sjeuDis 


1$ 9 9 9 ` A A. 


~ 


SAS 1304 
4 Á hh hhh an LG 


ginn 


` 





1 Attitude Director Indicator (ADI) - 


The AD! (sometimes called the "level ball") is used to help 
register your plane's position relative to the horizon as it rolls 
and pitches in any direction. 









Visualization Aids for the F-16 Pilot: When you're up in the air flying around, watch the 
position of the ADI change as the plane banks and rolls, or changes altitude. Note how the. 
line separating the sky from the ground matches to the “waterline” on the Radar screen, the 
lines of the Flight Path Ladder, and to the real horizon line itself. Most pilots use all these 
visual cues when flying their jets. When things get hot and heavy up there, it's nice to have 
several ways to orient yourself as your eyes are darting around the Cockpit. - 






Stick Centering Indicators 


These slide indicators help align your F-16's stick, providing a 
visual aid in addition to the cockpit items previously mentioned. 
When the pointer is centered in both the pitch and roll bars, the 
F-16's stick is "centered". 


Sensitivity Indicator 


A feature specific to your computer version of the F-16, this 
indicator sets the sensitivity of the plane to pitch and roll speed. 
——— The sensitivity varies from 0 to 9. If you select "0" sensitivity, 

the plane will be less "sensitive" to changes in direction, and will be easier to control. At the 
"9" setting, the tum, dive, and climb characteristics of FALCON are virtually identical to the 
actual F-16, with the most realistic setting being "9" sensitivity while flying at the rank of 
Colonel. The default sensitivity level is "5". Press * [ * (Left Bracket) to decrease the sen- 
sitivity level, or * ] " (Right Bracket) to increase it. 


(Wheel) Brakes Light 





The Wheel Brakes are used to control the F-16 when it is on the 
ground. When this light is on, the Wheel Brakes are engaged. 


When you first enter the FALCON cockpit, the Wheel Brakes are engaged. When you 
press the Jet Fuel System Start key (“+”) to start your engine, make sure the Wheel Brakes 
are left engaged unless you want the plane to start rolling. You can release the Wheel 
Brakes at any point (by pressing the "W" key) if you want to taxi the plane to a specific 
runway. Reengage the Wheel Brakes when you wish to stop. When in position for take-off, 












(Nose Wheel Steering) System and/or Wheel Brakes may be damaged, depending on 











‚gave the Wheel Brakes engaged until RPM is between 60-80%, then disengage wem. If 
you wait until after RPM has reached 80% to release the Wheel Brakes, the NWS 





your rank at the time. in similar fashion, the Wheel Brakes are used to stop the plane ` 
completely upon landing (within the same RPM guidelines). You should use Air Brakes to 
slow down the F-16 when its still packing a full head of steam after touching down. Wheel 
Brakes are designed to stop the plane only when it's moving slowly. — = 


RPM Gauge 


The RPM (Revolutions per Minute) Gauge reflects the percent- 
age of power being applied with your F-16's engine. The 
numbers on the gauge represent increments of percentage (76) 
power that the F-16 engine is producing at any particular time, 
from zero all the way up to 100 percent. All other factors being 
equal, the percentage of RPM directly relates to the plane's 
airspeed. After you play FALCON for a while, you'l know instinctively what percentage of 
power to apply to reach a certain airspeed. 


As you increase in rank during the game, you'll be required to monitor the RPM Gauge ` 
more closely. The most common situations with RPM percentage are during take-off 
procedure. Some of the percentages to remember: Your plane will start to rol @ 40% 
RPM during start-up. From takeoff position, throttle should be increased to between 60- 
80% RPM before releasing the Wheel Brakes to proceed down the runway. If you wait to | 
release the Wheel Brakes until after 80% RPM is reached, the NWS (Nose Wheel Steering)! . ` 
System and Wheel Brakes may be damaged. Increase RPM to 100% (and invoke the Af- | ©- 
terburner) for a shorter take-off, or to compensate for a heavy load. | 


Stall Light 


The Stall Light illuminates when you've exceeded the F-16's 
engine performance envelope, causing it to stall. This can occur 
for various reasons, but the most common one is that air intake 
has been reduced sharply, due to performing maneuvers either 
at high aititudes in thin air or at too low an airspeed. 












FALCON does not stall under any circumstance at First Lieutenant or Captain ranks. At 
Major level and up, however, the F-16 will be increasingly more susceptible to stall condi- 
tions. During a stall, your plane will begin to shake. The best action to take during a stall is 
lo accelerate in a dive until the engine refires and stabilizes, then level off. You'll start to 
realize after playing the game for a while why dogfight engagements take place at middle 


altitudes. Plane engines gasp for air as well as fuel, and there's not much of it at high © 
altitudes. Pius, you occasionally need room to recover beneath your position, and the 
ground can greet you fairly quickly when youre flying at Mach 1. 





Effect of Rank on the Enem; 


Effé.t of Rank on You and the F-16 
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Caution Lights 





i The Flaps have been damaged and frozen in their current state. If they were up 

f when the damage occurred, they stay up. Since Flaps help curb excessive speed, 

é the plane may be much harder to land. If the Flaps were down when the damage 
occurred, they stay down. This will hamper your plane's maneuverability, and 

4 prevent it from reaching top speed. 


f 


f STORES 


/ p 
/ FLAP ⁄ 
f 
/ 
f 


f If the STORES light appears, weapons cannot be released from extemal stores. 
g However, the M61 cannon (machine gun) and any AIM-9J/9L missiles can stil be 
é used, if available. 


É BRAKES 


f 


were open when the damage occurred, they stay open. Similar to Flaps damage, 
$ this situation severely alters your plane's maneuverability, and forces it to fly at 
ff reduced airspeed. 1f the Air Brakes were closed when the damage occurred, they 
stay closed. The F-16 will be harder to land in some situations without the ability to 
brake and slow it down. 


; 
⁄ 
f 
Y 
y 
GUN JAM f 
/ 
/ 
/ 
y 
f 
/ 
£ 


The BRAKES light indicates a failure in the Air Brakes system. Ií the Air Brakes 


The GUN JAM waming indicates that your M61 cannon is jammed and won't fire. 
You will have to rely on any remaining external stores for combat purposes, 
assuming that they are functioning OK. 


NWS 


1$,19$ us 


f If the NWS light is illuminated, the Nose Wheel Steering System has been damaged 

f due either to (1) not following proper take-off procedures, (2) not landing well on ap- 
proach, or (3) being hit by enemy fire. If the NWS System is disabled, the plane will 
not be able to be steered once it has landed, risking more severe damage if it 

f doesn't land very straight and moves off the runway. 


y 


"PPP 2 224 
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POP. Y 
WEP ARM 


N 


Can't arm the selected weapons. Once again, you'll have to rely on any remaining 
M61 rounds, if the gun is functioning. 


BARA 


ECM 


~ 
**»* 


A UVa YA 


f The Threat Indicator is out. You won't be able to detect incoming MiGs unless they 
$ show up on your Radar screen, assuming it's functioning. You may have to make 
visual contact. Make it through this and the Sierra Hotel may be your permanent 


f home. 


ff BURNER 


f The Afterbumer cannot be invoked. This will eliminate quick acceleration, which 
y could make the difference in completing a maneuver successfully or making a quick 
gelaway. 


f 


f RADAR 


# The Radar display is inoperable. You will have to rely on the ADI and visual contact 
ff to orient yourself to the horizon, and you'll be severely limited in how well you can 
f track a MiG on the screen. 


ENGINE 


/ 


f Signifies a partial or complete loss of power to your F-16. If you're not able to 
maintain any altitude or momentum, the power loss is complete, and you'll have to 
/ eject. 


é HUD 


f When this light is on, you'll probably know it already, because the HUD glass will be 
é blank. At this point, you have to rely on visual sighting and the backup gauges in 
f the main cockpit and side views to survive. It's probably a good idea to tum tail and 
⁄ head for home, if you can. 


f 
f 
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The Ran..s 


The difficulty levels in FALCON are determined according to military rank. The classifica- 
tions include First Lieutenant (lowest) and continue though Captain, Major, Lieutenant 
Colonel, and Colonel (highest). The ranks determine not only your plane's characteristics 
but the nature of the enemy as well. 


The charts on pages 92 and 93 summarize what the nature of play will be at each of the 
ranks: first for you and your F-16, and then following for the enemy. Most of the rank 
guidelines are self-explanatory. For example, your F-16's flight performance and restric- 
tions become more “true-to-life” as rank increases, making the simulation more challenging. 
The MiG opponent and SAMs also become more formidable. 


At First Lieutenant level, the program's realism is dampened a bit so you can easily become 
involved in the game and get a taste for most of its features. Playing as a Colonel will give 
you a highly realistic experience and require you to be very skillful to survive. However, just 
as the experience will become more exciting and dramatic, the rewards will also be more 
substantial at the upper levels. For example, it will be possible to receive certain medals 
and merits only at higher ranks. A detailed look at the scoring and awards process is 
included later on in Part ll. 


Taking a look at some of the specific rank quidelines: 
Super Engine vs. Normal Engine 


At First Lieutenant and Captain rank, FALCON has what we Call a “super engine". Air- 
speed is directly related to the percentage of RPM applied, and no other factors are 
involved. This engine output is easier for you to gauge because exterraneous factors like 
climb rate are not considered. In other words, you can initiate a nose dive at 50,000 feet 
going 500 knots and when you hit the ground, you'll still be going 500 knots if you havent 
increased or decreased the throttle with RPM percentage. This engine also does not stall. 


Weight and Drag Influence from Armament 
At Lieutenant Colonel and Colonel ranks, the type and amount of weapons and accessories 
that you carry on your F-16 will definitely affect its performance. Your plane won't be able 


to pull as many g's, and certain maneuvers may render the plane uncontrollable. The F-16 
is a terrific machine, but all jets have limitations. 


Ground Crashes 


As rugged as a jet fighter seems to be from an outward appearance, their landing mecha- 
nisms are somewhat delicate. Become adept at the takeoff and landing procedures before 


m 


Y 
flying at high ranks, because your landing gear cannot take a lot of abuse. You wun't 
necessarily have a fatal outcome from a faulty landing (or even a belly ftop!), but your 
superiors and the taxpayers won't be too excited. 


Possible Outcomes After Pilot Ejection 


Since FALCON isn't exactly real life, you don't have to worry about not making it through an 
ejection sequence at lower ranks. However, at Major level or above you risk being 
captured by the enemy if you bail out behind enemy lines. The probability increases the 
further behind enemy lines that you eject. In FALCON, being taken Prisoner of War 
(POW) Is a permanent condition. (If you crash behind enemy lines, you are declared 
MIA, or Missing In Action.) Plus, fighter pilots know that ejection even in friendly territory 
doesn't necessarily lead to a safe trip home, because of possible complications from the 
ejection itself. Ejection should be treated as a definite last resort at upper ranks. 


Possibilities of Pilot Blackout or Redout 


Modern fighter jets can perform some pretty amazing maneuvers and still retain their 
structural integrity. Now, if the same was only true for their pilots! Even with advances in 
flight suits and cockpit design, there are still limits to what a pilot's body can withstand from 
the force of high-speed turns. 


At Major rank or above, you risk pilot “blackout” if your plane sustains a maneuver in 
excess of 8 g's. The excessive force crams the pilot into the seat and pushes his blood 
supply downward. You'll know you're in trouble because the screen will start to fade out 
before going completely black. (A pilot loses the ability to distinguish colors during the initial 
stages of a blackout, producing in effect a “whiteout”.) Part IV discusses high g forces, 
which are usually the result of sharp and climbing high-speed tums. 


Blackouts are the result of “positive” g forces. Equally as dangerous are "redouts", which 
are caused by pulling “negative” g forces. Negative g's are a result of pushing the stick 
forward into a dive too fast and for too long. The blood rushes to a pilot's head as he 
effectively gets "pulled" from the seat, and this time the screen will go progressively "black", 
signifying the darkening effect from the blood pressure on your eyes. On the average, the 
human body cannot withstand a negative g force in excess of -2.5 g's before experiencing 
a “redout”, and possible rupture of blood vessels in the upper body. 





Pilots say that even when blackout or redout occur, they can still recover from it and regain 
control of their senses. What you must do in FALCON to recover from these kinds of 
situations is to try and remember what the most recent event sequence was that got you in 
trouble. When the blackout or redout starts to occur, move in the opposite direction (or at 
least stop the current action). You should recover from the dilemna, assuming all your 
other ducks are in a row, so to speak. 
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The M.ssions 


FALCON contains a variety of air-to-air and air-to-ground missions to test your flying skills. 
All missions take place in a landscape arena consisting of enemy territory as well as a 
"friendly" area where your airfield is located. 


The individual mission descriptions will detail where you need to fly and how you need to 
perform the mission to be successful. The following map of the FALCON landscape gives 
an overall view of what the arena looks like, with the locations of individual SAM sites, 
bridges, airfields, and other landmarks noted. 


Your COMED screen in the cockpit toggles to show a reduced-size version of the map, 10 
assist in reaching your target. Even more important, it helps you get back home. 


THESE TWO QUADRANTS 
ARE FRIENDLY TERRITORY 
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BUILDINGS 





Objective: 
Effective Weapons: Mk 84 Low Drag 2000Ib Bomb 
AGM-65B Maverick Missile 


Bomb Practice Buildings 


Every rookie pilot needs a confidence builder and flying the Milk Run should do just that. 
Use this mission to become familiar with both the Mk 84's and the AGM-65B Maverick's 
delivery systems. The Milk Run is also an excellent choice for improving takeoff and 
landing skills. 

Veterans enjoy flying the Milk Run. it gives them a chance to improve their skills and 
explore the outer edge of the F-16's flight envelope, otherwise known as "chasing demons". 
Use this opportunity to get familiar with the way your plane flies at higher skill levels. 


Food for thought: Many pilots have “bought the farm” while flying the Milk Run because 
they were too busy showing off and hotdogging. Stay alert! 


Black Bandit 





Objective: 

Effective Weapons: AIM-9L Ail Aspect Sidewinder Missile 
AIM-9J Sidewinder Missile 
M61A1 Gun 


The Black Bandit has been creating havoc for months. He's the enemy's best pilot and 
today he's up, circling and challenging your base to send up their best. Well kid, here's 
your chance to prove how good you really are. 


Keep your eyes open. If you find yourself in a bad situation, get out of it. Don't try to play 
hero. Take your best shot first. The Sarge may be able to help out by getting you some 
AIM-9L All Aspect missiles. You'll have a fighting chance to take him out with a head-on 
shot using these. They're hard to come by, but if the Sarge can get some, use them. 


The Bandit will come in from due north of your airfield. Good luck, you're going to need it. 
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Hornet Nest 





Objective: Destroy Enemy Runway 
Effective Weapons: Durandal Anti-Runway Bomb 


Denying the enemy use of their runway will severely cripple their ability to harrass your 
planes. Your job is to knock out the Central Airport with the Durandal Anti-Runway weapon 
by hitting the airfield where the two runways intersect. 


Extra fuel tanks will help extend your flight time, giving you the luxury of engaging the 
enemy after delivering your load. An ALQ-131 is also recommended to protect you from 
SAM launches. This airport is heavily protected by SAMs and MiGs. 


Bear’s Den 


Objective: Destroy Enemy Communication 
Center 

Effective Weapons: Mk 84 Low Drag 2000lb Bomb 
AGM-65B Maverick Missile 


The enemy's communication center handles all their logistics and coordinates all attacks. 
Operation Bear's Den requires you to destroy this hotbed of activity. The center is well 
protected by SAMs. Shoot at the building's base to blow it up. We recommend that you 
come in low and fast, deliver your weapons, and get out of there as fast as possible. Dont 
loiter around and become MiG chicken feed. 


Venus Flytrap m 


Z 





Objective: Destroy SAM Site 

Effective Weapons: Mk 84 Low Drag 2000Ib Bc 
AGM-65B Maverick Missile 
M61A1 Gun 








Within 24 hours, Strategic Air Command will launch a major strike to totally v. stroy the 
enemy's Regional Airfield. Before they can launch, you must destroy both SAM sites 
protecting the airfield. SAMs or MiGs will be up. The Flytrap is heavily protected and the 
enemy doesn't take too kindly to those wanting to bomb them. If you're shot down, there's 
à very low probability of being rescued. 


Like other bombing missions, avoid engaging any MiGs until you've accomplished your 
primary objective. If you're successful at eliminating the SAM sites and have enough 
weaponry left over to take out the airfield for SAC's benefit, they will appreciate it very 
much. However, you will have to decide at the time whether it's worth the extra risk. 








BUILDINGS 


Objective: Destroy Enemy Headquarters 
Effective Weapons: Mk 84 Low Drag 2000Ib Bomb 
AGM-658 Maverick Missile 


Enemy headquarters is located due north of the Flytrap and nestled in a valley beneath the 
foothills. Attacking their headquarters will deliver a blow to enemy morale as well as 
eliminale a key communications center. You need to destroy both buildings to achieve your 
goal. 


Take an ALQ-131 and beware of the SAM site adjacent to the headquarters buildings. 


Double 
Dragon 


= 





Objective: Destroy Both Suspension and Cantilever Bridges 
Effective Weapons: Mk 84 Low Drag 20001b Bomb 


AGM-65B Maverick Missile (Suspension Bridge only) 
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Purple Heart 


The Purple Heart decorates any member of the Armed Forces that is 
injured in action. The first Purple Heart decoration issued was a simple silk 
or cloth purple heart trimmed with white lace. Today's medal has a profile 
of George Washington in a field of purple. 





Distinguished Flying Cross (DFC) 


ure 


The Distinguished Flying Cross (DFC) is given to pilots in recognition of 
their outstanding achievement or heroism while flying. This medal was first 
awarded to Charles Lindbergh by President Coolidge for Lindbergh's 
historical crossing of the Alantic in 1927. 


BAHAY 





To quality fora DFC, you must: 


1. Successfully complete Dragon's Jaw, Dragon's Tail, Hornet's Nest, Bear's Den, Double 
Dragon, or Strike Palace without using an ALQ-131 pod. You must also fly at Major's 
rank or higher. | 

OR 


2. Successfully complete Dragon's Jaw, Dragon's Tail, Hornet s Nest, Bear's Den, Double 
Dragon, or Strike Palace; plus engage and destroy two or more MiGs. You must also fly 
at Major s rank or higher. 


Silver Star 


This meda! was authorized in 1918 for the purpose of decorating armed 
forces members who performed acts of heroism and gallantry against an 
armed enemy. It is awarded for those acts not great enough to merit the 
Medal of Honor or the Distinguished Service Cross. 





To obtain a Sitver Star, you will have to successfully complete one of the following 
missions: Rattiesnake Roundup, Dragon's Jaw, Dragon's Tail, Hornet's Nest, Bears Den 
Double Dragon, or Strike Palace without an ALQ-131 jamming pod. Destroy two or 
more MiGs In a simultaneous engagement. You must also bomb your primary target 
and a secondary target. You must fly at Major's rank or higher. 


A second way of receiving a Silver Star is to destroy four or more MIGs at Major level. 








Alr Force Cross | a 
The Air Force Cross was established by Congress in 1960 and is 
awarded only to those individuals who have performed outstanding 
acts of heroism against armed enemies in a hostile environment. 


In FALCON, the Air Force Cross has the same requirements as the 
Silver Star with two exceptions: you must fty at Lieutenant Colonel or 
Colonel rank, and return the F-16 safely to your home base. 


Medal of Honor 


The Medal of Honor, sometimes called the Congressional Medal of 
Honor, is the highest award in the nation and is presented by the 
President of the United States. The Medal of Honor is given to those 
members of the Armed Forces who perform acts of gallantry "above 
and beyond the call of duty" against overwhelming odds and against 
an armed and hostile enemy. The history of this medal dates back to 
1861 when Congress first authorized it for the Navy. The medal bears 
the head of Minerva, the Roman goddess of war. 


Only by flying at Colonel level are you eligible for the Medal of Honor. You need to shoot 
down a minimum of three MiGs In at least one simultaneous engagement. Also, 
bomb a primary and secondary target without an ALQ-131 ECM Pod in any of the 
following missions: Dragon's Jaw, Homet's Nest, Bear's Den, Strike Palace, Double Dragon 
or Grand Slam. 


MET 7/7777 Ribbons 
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Ribbons are awarded for sucessfully completing the 

` à objectives of any mission. Returning your plane 
safely to the base Is always Important but Is not a requirement for receiving a ribbon. 
In the U.S. Armed Forces, an “oak leaf” is presented instead of a ribbon, if the particular 
ribbon has already been received for previous success in a similar situation. The number to 
the right of the ribbons represents the number of oak leaves you have received since first 
appearing on the roster. 


MIG Kills WÁ 


The program will automatically tally the total number of MiGs you've shot down since your 
name first appeared on the Duty Roster list. 
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Turn Radii by Speed 
| (4g tum Elapsed time: 17.15 seconds) 
400 knots 
200 knots 180° 
360° 123,65 





72° 
An r222,885ft 


The ability to pull g's is dependent upon a plane's flight performance envelope. Flying 
beyond the envelope (chasing too many demons too far) can result in a stall or total loss of 
control of your plane. The two constraining factors that limit your flight envelope are altitude 
and speed. The Flight Performance Envelope Chart below illustrates the sustained per- 
formance limitations of the F-16. Your F-16 might be able to exceed these curves for brief 
moments of time without incident but we don't think General Dynamics will honor any war- 
ranties if you push the envelope too far and crash and bum your aircratt. 


FLIGHT PERFORMANCE ENVELOPE 
Parc qnss EET 
60000 a 4 I — 
eee 
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Keeping Your Energy High 
A common mistake made by rookie pilots is flying their aircraft either too slow or too fast 


Those flying their planes too slow are under the false assumption that slower speeds result 
in tighter tums and advantage during high-g ACM environments. Pulling high g’s bleeds off 
(reduces) airspeed. Note in the Flight Performance Envelope chart that flying too slow 
results in lower g capabilities. Pulling g's can force your F-16's airspeed to fall below the 
Stall rate, resulting in an uncontrollable dive. Remember: Speed is energy. Energy helps 
you get in and out of battle. Running out of airspeed {the same as running out of energy) is 
no fun in the heat of battle. 


On the other hand, rookies have been known to carry this too far and attempt to dogfight 
travelling at Mach 2 (over 1,000 knots per hour). Trying to maneuver at Mach 2 is like trying 
lo control a rocket that has gone ballistic. 


As with everything else in the world, there is a happy medium. Most dogfights occur 
between 500 and 700 knots. This is the optimum speed for high g maneuvers as well as 
maintaining a high energy state. 


How to Pull Out of a Stall 


Leaming how to pull yourself out of a stall can be a lifesaving matter. Flying beyond your 
plane's performance envelope can result in a stall. If you're flying too fast and trying to 
pull too many g's, all you have to do is relax off the stlck. 


Stalling because you've lost too much airspeed is a completely different matter. You can 
convert altitude Into energy (alrspeed) by golng Into a dive until you've built up 
enough airspeed and control before pulling out. Pulling out too soon or too hard can 
result in another stall so we recommend that you dampen your controls (at upper ranks) by 
using Trim Control as you pull out of the dive. 


A paia —. ` into a dive 
Bed 
A 1 Build speed by releasing 


stick until speed > 300 
knots 


Gently, with trim control, „ / 
pull out of the dive 
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If you are can ,..ig any external tanks of additional fuel, remember that fuel is drawn from 
these tanks first before the intemal capacity is used. The main internal tank will automati- 
-cally switch in once all the fuel from the external tanks has been exhausted. | 
Check your Fuel Gauge on the left cockpit panel to make sure the needie for any extemal 
tanks is at "0" (zero). At this point, you may jettison your external tanks (Option-C) to : 
reduce weight and drag, and therefore increase your F-16's maneuverablity, stability, and 
| ! ..  . acceleration. . M CM a s 






Air Combat Maneuvers and Training 


Fighter pilots have to rove in the area alotted to them in any way they like, and when they 
spot an enemy they attack and shoot them down . . . anything else is rubbish. 


BARON VON RICHTHOFEN 


To be successtul in the fighler business the air crew must, first and foremost, have a 
thorough background in fighter tactics. They must acquire an excellent knowledge of all 
their equipment. Then they must approach the problem with a spirit of aggression and with 
utter confidence. 


LT. R.S. LORD 
ROYAL NAVY 


We agree with the Red Baron that a good pilot is more important than any plane. However, 
if he had lived to see the agility of modern-day jet fighters, he might have changed his tune 
about the simplicity of air combat. Being aggressive isn't the only prerequisite to success in 
dogfight battle today. Rather, the pilot must be well trained in air combat maneuvers, and 
apply an aggressive behavior to the fighting situation in light of his particular fighter's 
capabilities. 


The superior agility of the F-16 enables the pilot to perform maneuvers that have been 
impossible in the past. In the same light, its superior capabilities can create such stress on 
the pilot that its agility can create a problem in itself. For example, the plane's ability to pull 
9g's in a matter of three seconds enable it to turn in an incredibly tight arc. However, as 
you've already learned, that same capability will cause most pilots to black out in the 
process. At the upper levels of the simulation, FALCON is true to the F-16 in this respect. 
You must remember that the pilot and plane are working together, and following any series 
of maneuvers precludes that you, the pilot, know exactly what your plane can do and work 
in harmony with it. 


The maneuvers that we will be discussing are standard ones employed by fighter pilots 
throughout the worid. 


The ACM (Air Combat Maneuvers) Menu 


The FALCON Menu Bar has a Menu entitled "ACM" (Air Combat Maneuvers) that you can 
choose from to watch a MiG perform any of a select list of maneuvers. This special training 
menu can be invoked at any time after you've entered the cockpit. We'll describe the 
process by which you make selections from the ACM Menu and follow that with individual 
discussions of each of the different maneuvers. 
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HighG Yo The High G YoYo is an offensive maneuver - Vertical Loop 
that is a reaction to the "Break". Because the 


attacking plane is unable to hold position with 
the plane that is "breaking", it starts to pull 
less of a hard turn and moves vertical as weil. 
During the climb, it rolls in the general 
direction of the predominant tum, so it can 
p make an aggressive dive at the breaking 
P plane from what is now a more favorable 
position. Like the Immelmann, this maneuver 
is an example of using a vertical move to 
AN enable your plane to change position in less 
of a horizontal piane than a more conven- 
APT tional tum. If this maneuver is performed 
precisely, it can be very effective because the 
other "breaking" plane will find it hard to 


detect your position. However, if you —— dfi 
combine an ineffective turn with inadequate 
speed in the climb, the other plane will have The Vertical Loop is used as an evasive maneuver. In its purest form, you puli into a sharp 
plenty of time to move away. climb and simply come over the top and continue in the same direction. You may be able 
| to pull in behind the other plane. Otherwise, since the loop is relatively easy to perform, 
Low G YoYo This maneuver basically takes the opposite you can use it is a decoy while setting up another maneuver to execute immediately after 
PR approach than the High Speed YoYo to coming out of the loop. 
resolve a stalemate with a “breaking” plane. i 
Rather than go vertical, the attacking plane Straight 
goes into somewhat of a dive while maintain- 
ing as much of the turn as possible. The If you select this maneuver from the ACM Menu, the MiG will travel in a straight line, 
"E attacking plane then pulls up behind the other whatever the heading (not necessarily parallel to the ground). 
plane in a more favorable position. Don't dive 
>>> too low or overtum, because the other plane 
will probably roll in behind you. Level 
Fli p Yo Yo This is a slight variant from the Low G YoYo. Even more straightforward than the previous sequence, the MiG will travel not only straight, 
Rather than do a pure dive and risk pulling but level to the horizon as well. Like we said earlier, use this "maneuver and the previous 
- SED" too many negative g's, roll your plane after "Straight" to get the feel of firing at the MiG. 
initiating the dive. You'll also be able to pick 
up speed faster in this move than the more : 
enn conventional Low G YoYo. Take care to not Scissors 
e overshoot the other plane because of 
excessive speed buildup. This maneuver results from a successful Break by the plane under attack. As the attac«ing 
plane overshoots its target, the other plane tries to tum the tables and move in behind the 
>>> previous attacker, and both planes roll and crisscross the other's path as each tries ts -ain 


the advantage. Your F-16 has an inherent advantage over the MiG-21 in this maneuver 
because of its better turning characteristics, but the MiG pilot is very skilled. The Scies~s 
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FALCON contains a cockpit flight recorder (commonly called a "Black Box‘) that records 
your F-16's flight path (and the same for any MiGs in the area) over a period of time. It's 
primarily designed for these purposes: 


« To show an "Instant replay” of a MiG encounter, so you can analyze your perform- 
ance in dogfighting the enemy plane; 


» To play back any of the sequences selected from the ACM Menu, So you can get à 
better perspective of the maneuver being executed; 


- To play back any of your flight paths (even just messin‘ around) so you can get a 
different view of what your plane Is doing. 


You can invoke the Black Box (with the Option-B key combination) at any time after you're 
inside the plane; or during the Awards screen, if you want to see the sequence of events 
that led to the end of your flight (whatever the outcome!) 


Your F-16's path is represented by a black line, while any MiGs appear as gray lines. Any 
MiG that appears on a Black Box trail is picked up from one of two ways: either because il 
showed up on your Threat Indicator, or your ground support crew's electronics picked it up 
and communicated the data through to your recorder. 


As the next example shows, it Keeps track of the flight path from three different views: 1) 
looking down on the path from directly above, 2) ground level looking from west to east, 
and 3) ground level looking from south to north. 


AA ee 


` 1 
T T This series of images may 
Lj it make the orientation of the 
Black Box views a litte 
clearer. They represent 
how a common object 
would look from all three of 
the different views. The 
usefulness of each view 
j (because of its direction) 
will depend on what's going 
on flight-wise at the time, 
which is precisely why 
there are throe different 
IÍ view directions. 





HIVE 


furem 


The Black Box starts recording from the moment you enter the cockpit and remains on for 
the duration of any flight. It will record up to 10 minutes of flight, with the average being 
about 4-5 minutes. The total time recorded depends on the complexity of the event. For 
example, if there are three MiGs in the area, it will record fewer total frames because of 
having to keep track of the trails of four different planes. When it reaches the end of its 
"tape", the history of the flight starts to diminish from the beginning end. If you fly a long 
ways and encounter an enemy plane before invoking the Black Box, the "beginning" of your 
taped path when you invoke the Black Box may be well after takeoff. 


Black Box Controls 
Play 


Move the arrow cursor over the play symbol and click the mouse or QuickStick button. 
Every click replays a small portion of the flight path(s). Hold the mouse or Quickstick button 
down to watch the whole path without interruption. When you reach the end of the tape 
while pressing the play button, the sequence automatically restarts from the beginning. 


Playback of the tape is sped up significantly over original flight ime so you can make a 
quick analysis. 


Clear 


Clears the screen of the current trail(s) and recenters the path(s) before showing the next 
section. If you have a long recording and are viewing the path from a small scale, you will 
have to clear the views occasionally to see the complete path. Pressing clear does not 
remove the path from memory. It merely allows you to clear the screen of the previous path 
portion, so you can better view the remainder to follow. 


—— — ——— 
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not see any snap ìs on the Awards screen relative to your finish. 


Quit 


Choose this option to exit the program entirely. 
ACM Menu 


This menu contains a list of sixteen Air Combat Maneuvers for you to use as a training 
mode for dogfighting enemy planes. Most are common ACMs used by fighter pilots 
everywhere. A couple of the maneuvers (Straight, Level) have been added by us to 
enable you to more easily follow the MiG and get in some target practice. You can make a 
new ACM selection at any time. When you're finished with the ACMs, choose either Abort 
Mission or End Mission from the File Menu to return to the DUTY ROSTER screen. From 
here, you can resume the normal mission and flying procedures. 


Scenery Menu 


You can make choices from this menu to design the visual nature of the FALCON land- 
scape to your personal preference. 


Dots Only 


Choose this option when you want to tum off the "detail" elements of the landscape, which 
include natural objects such as mountains and takes, as well as man-made structures like 
bridges, buildings, and SAM sites. You would select "Dots Only” when you're on a dogfight- 
ing mission and want to speed up program operation resultant from a landscape with fewer 
elements. Obviously, you wouldn't make this selection if you plan to attack ground targets. 


Detail Only 

Although the "dots" on the FALCON landscape were designed to enhance the visual 
relationship of the ground and provide an enhanced sense of perspective, some of you may 
prefer to "tum off the dots" and keep the detail of natural landmarks and man-made targets. 
Program speed will increase slightly when this selection is made. 

Detail & Dots 


The most natural version of the landscape, with natural elements and man-made structures 
always visible. 


A a ae 





1 





Otherwise, you might 


Automatic 


Although not as pure an option as "Detail & Dots", this selection tums off the landscape 
features only when two conditions occur in tandem: a MiG has appeared on the Threat 
indicator, and you are not currently in one of the Air-to-Ground HUD modes. This way, 
you can have a speedup of airplane movement during air-to-air combat, but have the 
ground dots and object detail when on a ground strike mission. If you are flying 
around and have an Air-to-Air HUD mode activated when the MiG appears, the landscape 
automatically "turns off". As soon as you select an Air-to-Ground HUD mode (either 
because you have defeated the MiG or simply want to perform a ground attack), the ground 
‘dots and detail” will reappear. Ground detail will also return automatically as soon as any 
MiGs present have either left the picture or been destroyed, no matter what the HUD mode 
is. 


Automatic is the default landscape setting. 


IMPORTANT! 


` No matter what landscape detail and dots selections are made, the program wil always 
return at least the landscape "detail" when your plane is below 10,000 feet of altitude. ~ 


crash into mountains that you can't see, creating the Bermuda ` ` 





___ Tangle of jet fighters. š 





Control Menu 


Select from Key, Mouse, or Joy, respectively, if you choose to control your F-16's direc- 
tional "stick" via the Keyboard, Mouse, or a Kraft QuickStick. The currrent selection will 
have a check mark beside it. 


Options Menu 


Normal Scale 

The default setting for the size of the enemy MiG-21 plane. This "normally sized" MiG 
performs in a very realistic fashion as your opponent, but isn't very easy lo see until it's very 
close to you (just like real life!). 

Large Scale 

Enlarges the MiG so that it's easier to see at a distance. Note that some of the MiG's 


movements may look a little strange at this setting, because the new "visual contact 
distance” relative to "actual distance” has been effectively cut in half. 
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Court-Martlg purt decision expelling a member from the Armed Forces 


Driver - term for pilot flying (rather than navigating) the plane in a two-seater; also used as 
a term for pilot in a one-seater, like the F-16. 


Duty Roster - crew chiefs list of available pilots 

ECM - electronic countermeasures 

Fighter Jock - slang term for fighter pilot 

g - unit of acceleration 

GSD - glide slope deviation 

HUD - head-up display 

ILS - Instrument Landing System 

Jamming - act of confusing enemy radar systems with radio frequency noise 

JFS - jet fuel system 

LD - locatizer deviation 

Lock-on - acquire a target with radar for the purpose of firing a weapon 

Mach - unit of speed measurement equal to the speed of sound 

MIA - missing in action 

MiG-21 - Mikoyan/Guryevich-21 Soviet-built jet fighter, the most common in the worid 
MIL - military power 

Military Power - standard power and acceleration measure 

Missing man formation - when a pilot meets an unfortunate and fatal demise, his 
squadron flies a pattern where one of the planes peels off away from the pattern, symboliz- 
ing their compadre's departure forever. 

Move in on his six - come in on the rear of another plane 


NWS - nose wheel steering 


NWSS/LGSI - nose wheel steering system/anding gear status indicator 
Pickling - setting a weapon to fire at one specific location, similar to a lock-on. 
POW - prisoner of war 


Pulling tead - purposely aiming in front of enemy plane to allow for distance to target and 
target speed in making sure fired weapon scores a hit. 


Rookie - pilot without flight experience 
RPM - revolutions per minute 


Splash one MIG - statement commonly spoken after successfully downing an enemy MiG 
jet fighter 


Spoof - slang term for “fooling” an enemy missile with flares or chaff 
SRF - FALCON shorthand for "strafe” 


Stick - pilot directional control 
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indi : 


A-A (see Air-to-Air) 
Afterbumer 20, 28, 29, 33, 45, 50, 53, 81, 
83, 85, 87, 96, 111, 129 
indicator 20, 28, 81 
A-G (see Air-to-Ground) 
AGM-65B Maverick Air-to-Ground Missile 
45-46, 55, 57, 70-72, 95, 96, 97, 
98, 99 
AIM-9J Sidewinder Missile 14, 40, 42, 55, 
57, 62, 86, 95, 96, 100, 109 
AIM-9L All Aspect Sidewinder Missile 40, 
42, 55, 57, 62, 86, 95, 96, 100, 
109 
Aiming Reticle (mobile) 31, 32, 33, 65 
Air Brakes 37, 38, 50, 58, 81, 83, 86 
Light 16, 81 
Air Combat Maneuvers (ACM) 15, 108, 115- 
121, 129 
- ACM Menu 115-117, 122, 126 
Break 118, 119, 120 
Dive Loop 121 
Engage 117 
Flip YoYo 118 
Head On 121 
High G YoYo 118, 121 
Immelmann 117, 118 
Lag Pursuit 121 
Level 117 
Low G YoYo 118 
Rollaway 121 
Scissors 119-120 
Split S 120 
Straight 117 
Variable Scissors 120 
Vertical Loop 119 
Air Force Cross (see Medals) 
Air Target Select key 40, 51, 62 
Air-to-Air 17-19, 50, 55, 127, 129 
Gun HUD (M61A1) 64-65 
Missile HUD (AIM-9J or AIM-9L) 62- 
63, 78 


Weapons Select 50, 53 ` 
Air-to-Ground 19, 31, 50, 55, 56, 60, 127, 
129 
Bombing HUD (Mk 84 or Durandal) 65- 
69 
Missile HUD (AGM-65B Maverick) 70- 
72 
Reticle (fixed) 67, 68, 69, 70, 71, 72 
Reticle (mobile) 72, 73, 74 
Strafe Gun HUD (M61A1) 64, 72-74, 
131 
Weapons Select 50, 53, 65, 71 
Airspeed 17, 18, 28, 29, 37, 83, 86, 90, 110, 
111 
backup gauge 85 
Scale 16, 17, 18, 28, 58, 59, 85 
ALQ-131 ECM Pod 14, 43, 44, 45, 51, 56, 
57, 79, 96, 98, 99, 102, 103, 129 
Altitude 17, 19, 29, 33, 34, 35, 37, 68, 69, 
71, 73, 83, 110, 111, 113 
Altitude Scale 16, 17, 19, 59 
AOA (Angle of Attack) 19, 37, 75-76, 129 
Indexer 16, 19, 35, 37, 39, 51, 58, 75 
Indicator 58, 75-76 
Apple Menu 125 
AR/NWS Light (see Nose Wheel Steering 
System/Landing Gear Status 
Indicator) 
Amament 13, 55-57, 92 
selection 13-15 
unlimited 13-14, 32 
weight and drag influence from 90, S2, 
114 
Attitude Director indicator (ADI) 16, 20, 32, 
33, 58, 72, 82, 87, 129 
Automatic sighting system 32 
Autopilot 51, 117 
Awards screen 100-105, 122, 125-126 


Backup (making a) 8 
Bandit 129 

Bear's Den (see Missions) 
BINGO (see Fuel) 

Black Bandit (see Missions) 
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Black Box 52, 122-124 
Blackout 88, 91, 92, 108-109, 115 
Bogey 129 
Bombing 65-69 

hits 103 
Bombs remaining 67 
Bombsight 31, 32, 33, 66, 68, 69 
Break (see Air Combat Maneuvers) 
Buy the farm 129 


Call sign 129 
Cantilever bridge 97, 99-100 
Captain (see Rank) 
Cat 3 load 109, 129 
Caution lights 85-88 
BRAKES 86 
BURNER 87 
ECM 87 
ENGINE 87 
FLAP 86 
FUEL SYS 88 
GUN JAM 86 
HUD 87 
NAV 88 
NWS 86 
OXY LOW 88 
RADAR 87 
STORES 86 
WEP ARM 87 
Center/evel plane 52 
Center Yaw/Pitch 52 


Clear Air-to-Ground (A-G) Target Lock 51, 


53, 68, 72 

Chaff 43, 44, 45, 50, 53, 79 

Indicator 79 
Climb 33 
Climb angle 18, 28, 29, 31, 32, 37, 60, 69 
Climb rate 29, 81, 90 
Closure rate 80 
Cockpit 16 
Cockpit Views 29 

front 26, 29, 48, 49, 53, 75-83 


left 21, 29, 30, 37, 48, 49, 53, 74, 84- 


85 


rear 33, 48, 49, 5., 37 
right 48, 49, 53 
autoview 48, 49 
Collisions 92 
Colonel (see Rank) 
COMED (Combined Map/Electronics 
Display) 16, 20, 30, 34, 58, 70, 
71, 72, 80, 94 
Radar mode 16, 20, 30, 39, 40, 51, 71, 
72, 77, 80, 87, 96 
Map mode 16, 20, 30, 34, 51, 71, 60, 
87, 94 
Coming over the top 41, 129 
Compass 21, 30, 85 
Cones of Vulnerability 17, 18, 41, 63, 129 
Control Menu 14-15, 26, 127 
Control Panel 128 
Court-martial 11, 101, 130 
Crash (ground) 33, 34, 37, 90-91, 92, 100, 
101 
Crater 33 


Directional Indicator (HUD) 24, 26 
DISC (disconnect) Light (see Nose Wheel 
Steering Systen/Landing Gear 
Status Indicator) 
Discretes (HUD) 
ARM 62, 64, 67, 71, 73 
IN RNG 67, 71, 72 
LCK 73, 74 
LOCK 62, 67, 68, 71, 72 
REL 67, 69, 71 
Displayed Impact Line 68, 69, 72, 73 
Distance to Target 68, 71 
Distinguished Flying Cross (see Medals) 
Dive 29, 32 
Dive angle 32, 60 
Dive bombing 31-34, 65 
Dive Loop (see Air Combat Maneuvers) 
Directional Indicator 61 
Double Dragon (see Missions) 
Double Trouble (see Missions) 
Dragon's Jaw (see Missions) 
Dragon's Tail (see Missions) 
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Oak leaf” > 

Options Meu 127-128 
Large Scale 127 
Normal Scale 127 
Slow Down 128 
Sound 128 


Pause key 22, 35, 39, 50 
Pickling 65-74, 131 
Pitch 60, 72, 74 
Pop-up bombing 31, 32, 65-69 
pickling 65-68 
approach 68-69 
climb and release 69 
Prisoner of War (POW) 11, 91, 92, 131 
POW (see Prisoner of War) 
Pulling lead 40-41, 63, 65, 131 
Purple Heart (see Medals) 


QuickStick 6, 8, 15, 24, 32, 33, 49, 53 
Quit to menu 51 


Radar (see COMED) 
Radar-guided missile 77, 79 
Rank 10, 11, 12, 22, 23, 33, 34, 38, 90-93, 
117 
Captain 12, 14, 38, 83, 90, 91, 92, 104 
Colonel 12, 77, 80, 82, 83, 85, 90, 92, 
97, 103, 103, 104, 117 
First Lieutenant 10, 12, 13, 14, 17, 22, 
32, 33, 34, 38, 67, 83, 90, 92, 
100, 104, 117 
Lieutenant Colonel 12, 83, 90, 92, 97, 
103, 104 
Major 12, 83, 90, 92, 96, 102, 104 
Rattlesnake Roundup 12, 96, 102, 104 
RDY (ready) Light (see Nose Wheel 
Steering System/Landing Gear Status 
Indicator) 
Redout 91, 92, 108, 112 
Rear View (see Cockpit views) 
Release Que 68, 69 


Reticle 
moving 65, 72, 73, 74 
fixed 67, 68, 69, 70, 71, 72 
Ribbons 103 
Right View (see Cockpit views) 
Rollaway (see Air Combat Maneuvers) 
Rookie 131 
Rounds 64, 72, 73 
RPM 27, 28, 29, 37, 38, 78, 83, 90, 131 
Gauge 16, 21, 26, 27, 58, 83 
Runway 17, 21, 30, 34, 35 


SA-2 Guideline Missile 43, 44-45, 92, 96, 97 
SA-6 Gainful Missile 43, 44-45, 92, 96, 97 
SA-7 Grail Missile 44-45, 92, 97 
SAM (Surface-to-Air Missile) 38, 43-46, 56, 
79, 92, 96, 97, 98, 99 
shoulder launch 38, 43, 97 
SAM site 38, 43-46, 56, 77, 79, 94, 96, 97, 
98, 99 
Scenery Menu 126-127 
Automatic 127 
Detail & Dots 126, 127 
Detail Only 126 
Dots Only 126 
Sensitivity 52 
Indicator 16, 58, 82 
Sierra Hotel 11, 80, 87, 105 
Silver Star (see Medals) 
68020 accelerator board 13, 128 
Snapshots 100 
Sound 51 
Splash one MiG 131 
Split S (see Air Combat Maneuvers) 
Spoof 131 
Stall 78, 90, 92, 111 
Stall Light 58, 83 
Slick Centering Indicators 21, 24, 82 
Stick control 22-26, 27, 28, 29, 33, 48, 49, 
52, 53, 54, 108, 111, 112, 131 
keyboard 14-15, 22-23, 26 
mouse 14-15, 22, 25-26, 49, 53, 54 
QuickStick 14-15, 22, 24, 26, 49, 53, 
54 
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Stores Control Panel 16, 31, 58, 64, 78 
Straight (see Air Combat Maneuvers) 
Strike Palace (see Missions) 

Super engine 23, 90, 92 

Surface-to-Air Missile (see SAM) 
Suspension bridge 97, 99-100 


Takeoff 92, 95, 101 
Target Designator 40, 62, 63, 64, 68, 71, 
72, 73 
flashing diamond inside 62, 63 
Targeted MiG 39 
Taxiing the aircratt 27, 28 
Ten Mile Radar Ranging Scale 17, 19, 63 
Threat Indicator 39-40, 44, 77, 87, 96, 122, 
126 
Threat Warning Light 77, 79 
Threat Warning System 44, 58, 77, 79 
Throttle 21, 26, 29, 35, 37, 38, 48, 49, 53, 
83, 90 
decrease key 35, 48, 49 
increase key 21, 26, 27, 28, 48, 49 
Trigger 24, 32, 33, 50, 53, 68, 69, 71, 72, 74 
Trim control 37, 52, 111 
Turn radius 30, 109-110, 112 


Variable Scissors (see Air Combat 
Maneuvers) 

Velocity Vector 60, 72, 74 

Venus Flytrap (see Missions) 

Vertical Loop (see Air Combat Maneuvers) 

View weapons stores 51, 78 

Vulnerability Cone 63 


Waterline 20, 72, 80, 82 

Wheel Brakes 26, 27, 28, 38, 50, 81, 82-83 
Light 16, 21, 26, 27, 28, 58, 82-83 

X mark 33, 51, 74 

Yaw 60, 84 


Yaw/Pitch Control 52, 74, 84 
Indicator 74 
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AVVISO IMPORTANTE 


Questo programma, per quanto riguarda il mantenimento delle variazioni stilistiche dei 
documenti, è compatibile con le versioni di WORD? fino alla 1.15 inclusa. 

Avremmo voluto e potuto estendere la compatibilità fino alla versione 3.0, ma la 
MICROSOFT?" ITALIA si é rifiutata di fornirci la documentazione relativa al nuovo 
formato. 

A] di là delle valutazioni su questa decisione, sulla cui motivazione il poeta Schiller si é gia 
espresso con grande lucidita, i possessori della versione suddetta dovranno archiviare 1 
document nel formato TESTO per la corretta utilizzazione con questo programma. 


Ricordiamo inoltre che le versioni fino almeno alla 1.15 inclusa di WORD® presentano un 
problema nella stampa di documenti contenenti 'soft hyphens' per la sillabazione, che si 
evidenzia in una scorretta spaziatura fra le parole. L'unica soluzione a noi nota per questo 
problema, che NON DIPENDE DAI NOSTRI PROGRAMMI, é quella di usare altri 
programmi per la stampa, come PAGEMAKER®, o definitivamente altri elaboratori di 
testo, come l'ottimo WRITENOW® 





MODULO PER IL CLIENTE 


MultiSpell ha richiesto circa un anno-uomo di lavoro. Se chi lo ha scritto fosse pagato come un 
insegnante di liceo, dovrebbero esserne vendute oltre 700 copie per pagarlo, senza contare 1] 
rischio, l'impiego a termine, mutua e tante altre belle cose. Siccome questo volume di vendite € 
chiaramente impossibile, l'autore e il distributore si aspettano che la loro decisione di metterlo in 
commercio ad un prezzo accessibilissimo sia confortata da una onesta presa di posizione contro la 
pirateria. In altre parole, se questo programma interessa un vostro amico o conoscente, invitatelo 
ad acquistare un originale. 

In questo modo, MultiSpell potrà crescere e acquistare nuove caratteristiche e funzioni. Quali? 
Citiamo a caso: 

- caricamento in memoria del dizionario per la massima velocità d'uso 

- maggiore interazione con altri programmi di elaborazione testo, come per esempio MACWRITE. 
- dizionari specializzati per categorie particolari: avvocati, medici, ingegneri, eccetera. 

- diteci voi 


SE DESIDERATE ESSERE INFORMATI SU NUOVE VERSIONI DI 
MULTISPELL (con la possibilità di aggiornamento a prezzo scontato) RIEMPITE 
E INVIATE QUESTO MODULO A: Ä 


EASY BYTE srl 
Viale dell'Oceano Pacifico 66 
00144 ROMA 


Nome e Cognome, o ditta 





Indinzzo A — — — — — — O PCg  —— O AO 


Per una nuova versione del programma, vorrei le seguenti aggiunte: 

_ a a a a a a a v. 
A A A AAA A A A —_ > 
nn 


A A mx A  — 
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